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
• ⚙️ OS Scripts: Run system-provided just recipes and scripts
• 📊 Status Command: View configuration and installed tools at a glance

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

Prerequisites:

• Go 1.21 or later
• Homebrew (for package management features)

git clone https://github.com/hanthor/bluefin-cli.git
cd bluefin-cli
go build -o bluefin-cli
sudo mv bluefin-cli /usr/local/bin/

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

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

Enable/disable bling for your shell:

# Interactive mode
bluefin-cli bling

# Enable for specific shell
bluefin-cli bling bash on
bluefin-cli bling zsh on
bluefin-cli bling fish on

# Disable bling
bluefin-cli bling bash off

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

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

Run OS-provided just recipes and shell scripts:

bluefin-cli osscripts

This discovers and lists all available recipes from /usr/share/*/just/ directories.

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)

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
│   ├── osscripts.go    # OS scripts discovery
│   ├── 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