Skip to main content

vanilla vs extra

This document outlines the split between standard core features and automated enhancements in bluefin-cli.

📦 Binary Versions​

You can build two versions of the CLI:

  1. bluefin-cli (Standard): The standard tool for management.
  2. bluefin-cli-plus (Plus): The enhanced version with deep automation.

🍦 Standard Features​

Both binaries include these features. They provide tools and resources; the user sets the final configuration.

FeatureCommandDescription
App BundlesinstallInstall tool bundles (CLI, AI, CNCF, etc.) via Homebrew.
Shell ConfigshellEnable modern shell enhancements, aliases, and tool integrations.
Init SysteminitStandard shell initialization logic.
System StatusstatusOverview of enabled tools, shell status, and environment health.
MOTDmotdManage system info and helpful tips.
Download FontsfontsDownload recommended dev fonts (JetBrains Mono, Fira Code, etc.).
Download WallpaperswallpapersDownload monthly wallpaper packs from ublue-os/tap.
Starship ThemesstarshipQuick switching between curated Starship prompt themes.

✨ Plus Enhancements​

These features are only included in the bluefin-cli-plus binary (compiled with -tags extra). They provide deep system integration and automation.

FeatureCommandDescription
Sunset Switchingsunset[Windows/WSL] Automatically switches system themes and wallpapers based on solar time.
Theme AutomationwallpapersAdds the ability to automatically generate and apply Windows themes after downloading wallpapers.
Font AutomationfontsAdds automated terminal configuration for newly installed fonts (Coming soon).

🏗️ Technical Implementation​

Build Tags​

We use Go build tags to gate "Extra" logic. The standard build omits files marked with //go:build extra. This keeps the standard binary lean and focused on core tasks.

Dynamic UI​

The interactive menu detects the features in each binary and adjusts its options. It hides headers and commands that the binary does not provide.