A powerful, modern CLI tool for managing shell configuration and development environment customization. Built with beautiful TUIs using Charm libraries.

• 🎨 Interactive Menu: Default TUI experience for easy navigation
• ✨ Bling: Toggle modern shell enhancements (eza, bat, ugrep, zoxide, atuin, starship)
• 📰 MOTD: Beautiful Message of the Day with system info and random tips
• 📦 Bundle Installer: Install curated tool bundles (ai, cli, fonts, k8s) from Universal Blue
• �️ Wallpapers: Install desktop wallpaper collections from ublue-os/tap
• 🎨 Starship Themes: Browse and apply Starship prompt themes
• 📊 Status Command: View configuration and installed tools at a glance

Build and install from source:

git clone https://github.com/hanthor/bluefin-cli.git
cd bluefin-cli
go build -o bluefin-cli.exe .

# Optional: move to a permanent location on PATH
New-Item -ItemType Directory -Force "$HOME\\bin" | Out-Null
Move-Item .\\bluefin-cli.exe "$HOME\\bin\\bluefin-cli.exe" -Force
$env:PATH = "$HOME\\bin;$env:PATH"

Enable shell integration for both pwsh and Windows PowerShell profiles:

bluefin-cli shell powershell on

go install github.com/hanthor/bluefin-cli@latest

Prerequisites:

• Go 1.21 or later

git clone https://github.com/hanthor/bluefin-cli.git
cd bluefin-cli
go build -o bluefin-cli .

On Windows, use go build -o bluefin-cli.exe ..

brew tap ublue-os/homebrew-experimental-tap
brew install bluefin-cli

Once published to Winget, installation will be:

winget install --id Hanthor.BluefinCLI --exact

Maintainers: automated Winget submission is configured in .github/workflows/winget.yml.

Simply run the command to launch the interactive menu:

bluefin-cli

Or explicitly:

bluefin-cli menu

View your current configuration and installed tools:

bluefin-cli status

Bluefin CLI includes a "Shell Experience" module (formerly "bling") that configures your shell with modern tools and aliases.

To enable the shell experience:

bluefin-cli shell bash on
# or
bluefin-cli shell zsh on
# or
bluefin-cli shell fish on

Or use the interactive menu: bluefin-cli menu -> "Shell Experience".

Features:

• eza: Modern replacement for ls
• bat: Syntax highlighting for cat
• ugrep: Faster grep
• zoxide: Smarter cd
• atuin: Shell history sync
• starship: Cross-shell prompt
• uutils: Rust rewrite of coreutilsl

Show the MOTD:

bluefin-cli motd show

Toggle MOTD for shells:

# Enable for all shells
bluefin-cli motd toggle all on

# Enable for specific shell
bluefin-cli motd toggle zsh on

# Disable MOTD
bluefin-cli motd toggle all off

Install curated Homebrew bundles:

# List available bundles
bluefin-cli install list

# Install specific bundle
bluefin-cli install ai       # AI tools
bluefin-cli install cli      # CLI essentials
bluefin-cli install fonts    # Development fonts
bluefin-cli install k8s      # Kubernetes tools

# Interactive mode
bluefin-cli install

Install desktop wallpaper collections:

# Interactive selection
bluefin-cli install wallpapers

# Install specific wallpaper casks
bluefin-cli install wallpapers bluefin-wallpapers aurora-wallpapers bazzite-wallpapers

# Non-interactive test run: apply theme + enable all automation
bluefin-cli install wallpapers bluefin-wallpapers --yes

# Non-interactive with explicit controls
bluefin-cli install wallpapers bluefin-wallpapers --non-interactive --apply-theme --theme Bluefin --enable-mode-sync --enable-auto-dark-light --trigger-source polling

# Use startup-only mode sync (no minute polling task)
bluefin-cli install wallpapers bluefin-wallpapers --non-interactive --enable-mode-sync --trigger-source startup

# Auto Dark Mode integration mode (startup sync + external mode-change utility)
bluefin-cli install wallpapers bluefin-wallpapers --non-interactive --enable-mode-sync --trigger-source autodarkmode

# Cleanup Windows sync artifacts/state/tasks generated by wallpaper integration
bluefin-cli install wallpapers cleanup

# Full reset for testing: cleanup + uninstall known wallpaper casks + local wallpaper folders
bluefin-cli install wallpapers cleanup --all

Non-interactive wallpaper flags:

• --non-interactive: Skip prompts and use provided flags.
• --yes: Shortcut for --non-interactive --apply-theme --enable-mode-sync --enable-auto-dark-light.
• --apply-theme: Apply a Windows theme after registration (WSL only).
• --theme <name>: Theme to apply in non-interactive mode (Bluefin, Aurora, Bazzite).
• --enable-mode-sync: Enable day/night wallpaper sync task.
• --enable-auto-dark-light: Enable 6 AM/6 PM light/dark switching tasks (requires --enable-mode-sync).
• --trigger-source <source>: Mode-sync trigger source (polling, startup, autodarkmode).

autodarkmode notes:

• Bluefin CLI ensures %LOCALAPPDATA%\\BluefinCLI\\set-light-mode.ps1 and %LOCALAPPDATA%\\BluefinCLI\\set-dark-mode.ps1 exist.
• In Auto Dark Mode, point light/dark custom script hooks to those two scripts.

you can change your prompy lookks Browse and apply Starship preset themes:

bluefin-cli starship theme

Install Starship if not already present:

bluefin-cli starship install

The bling command configures these modern CLI tools:

• eza: Modern replacement for ls with icons and colors
• bat: cat clone with syntax highlighting
• zoxide: Smarter cd command that learns your habits
• atuin: Magical shell history with sync and search (optional)
• starship: Fast, customizable prompt for any shell
• ugrep: Ultra-fast grep alternative (optional)

When bling is enabled in your shell:

ll      # eza -l --icons=auto --group-directories-first
ls      # eza
cat     # bat --style=plain --pager=never
grep    # ugrep (if installed)

• Interactive Menu Structure: A visual guide to the application's menu hierarchy and options.
• Available Tools: A comprehensive list of all tools and bundles available.
• Winget Publishing Guide: Steps to publish and maintain the Windows package.

bluefin-cli/
├── main.go              # Application entry point
├── cmd/                 # Cobra commands
│   ├── root.go         # Root command & menu default
│   ├── menu.go         # Interactive TUI menu
│   ├── bling.go        # Bling command
│   ├── motd.go         # MOTD command
│   ├── install.go      # Install bundles/wallpapers
│   ├── starship.go     # Starship theme management
│   └── status.go       # Status display
├── internal/            # Internal packages
│   ├── bling/          # Bling logic & embedded scripts
│   ├── motd/           # MOTD generation
│   ├── install/        # Bundle & wallpaper installation
│   ├── starship/       # Starship integration
│   └── status/         # Status checking
└── test/                # Integration tests

This project consolidates and modernizes functionality from:

• ublue-bling: Shell aliases and tool initialization scripts
• bluefin-cli (cask): Homebrew package management and MOTD
• ujust recipes: Task runner and development environment helpers

• Go 1.21+
• Podman (for containerized testing)
• just (for running recipes)

just build

# Run tests in container
just test

# Run tests locally
go test ./...

Launch shells with bling pre-configured:

just bash   # Test in bash
just zsh    # Test in zsh
just fish   # Test in fish

This project uses:

• Cobra - CLI framework
• Huh - Forms and prompts
• Lipgloss - Style definitions

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

• Universal Blue - For the original bluefin-cli and ublue-bling
• Charm - For the amazing TUI libraries
• The Homebrew community

• ublue-os/packages - Original package implementations
• Starship - Cross-shell prompt
• Homebrew - Package manager for macOS and Linux