Repository navigation
Description
Proposal
Make tuna-os/bluefin-cli the owner of the CLI experience for every Common consumer (Bluefin, Dakota, Utah): shell tools and aliases, the prompt hooks and the CLI Brewfile bundles. It replaces ublue-bling and /usr/share/ublue-os/bling/. It integrates uwelcome: uwelcome stays the terminal greeting, and bluefin-cli's MOTD commands and init scripts work through it where it is installed (tuna-os/bluefin-cli#527). bluefin-cli's own MOTD is only the fallback where uwelcome is absent (macOS, other distributions). The GNOME bluefin-bling extensions are unrelated and stay.
Utah is the reference implementation (projectbluefin/utah#1370; RPM from projectbluefin/utah-packages#1235).
What it replaces (old → new)
| Common today | bluefin-cli |
|---|---|
ublue-bling (gum toggle, appends ### bling.sh source start block) |
bluefin-cli shell <bash|zsh|fish> on|off (writes eval "$(bluefin-cli init bash)"; on/off also remove ublue-bling's block — tuna-os/bluefin-cli#523) |
bling.sh / bling.fish: eza, ugrep, bat aliases, open→xdg-open, direnv, starship, zoxide, mise, bash-preexec re-arm (#869) |
same set via bluefin-cli init (direnv, mise, open, re-arm in tuna-os/bluefin-cli#523; atuin off by default as in #1113, ugrep alias only when ug is installed, fish abbreviations with BLING_USE_ABBR=0 for aliases, load-once guard — tuna-os/bluefin-cli#528), plus fzf, uutils, carapace and per-tool toggles (bluefin-cli shell config) |
ujust bluefin-cli = ublue-bling + brew bundle --file=…/cli.Brewfile |
bluefin-cli shell $shell on + bluefin-cli install cli (embedded cli.Brewfile, synced from Common with provenance — tuna-os/bluefin-cli#526) |
uwelcome via /etc/profile.d/uwelcome.sh, fish_greeting.fish, /etc/uwelcome/config.toml |
Unchanged: uwelcome stays the greeting. Where uwelcome is installed, bluefin-cli motd show runs uwelcome, and bluefin-cli's init scripts greet only through it, once per terminal (they stay quiet when UWELCOME_SHOWN is set) and only when output is a terminal (tuna-os/bluefin-cli#527). Where it is absent, bluefin-cli shows its own MOTD: distro template /usr/share/bluefin-cli/motd.md + tips dir, admin override in /etc/bluefin-cli/ (tuna-os/bluefin-cli#525) |
ujust toggle-user-motd → uwelcome toggle |
Unchanged. bluefin-cli motd toggle (and the bluefin-cli motd menu) drive uwelcome enable|disable where uwelcome is installed, so both honor ~/.config/uwelcome/disabled |
| — | bluefin-cli status (reports uwelcome's state), bluefin-cli doctor [--fix] |
Migration
- rc files that
source /usr/share/ublue-os/bling/bling.sh: keepbling.sh/bling.fishas shims that runeval "$(bluefin-cli init <shell>)"(guarded bycommand -v bluefin-cli). Users keep a working shell with no action; the nextbluefin-cli shell … on|offrewrites the line. ublue-blingcommand: keep as a one-line shim toujust bluefin-cli.- uwelcome: nothing to migrate. Its files, config, translations and opt-out (
~/.config/uwelcome/disabled) stay as they are; bluefin-cli reads and writes the same state. - Bling helpers:
env.shandbash-preexec-rearm.shwere read only bybling.sh/ublue-bling; bluefin-cli keeps bash-preexec armed itself, so they can go. - Prompt:
90-bluefin-starship.sh/starship.fish(starship by default) still init starship outside bluefin-cli; a later step could make bluefin-cli own that default too.
Packaging options
- RPM from projectbluefin/utah-packages (source build, offline, SHA-512-locked: release tarball + the vendored-modules release asset added in feat(release): publish the vendored Go modules with each release tuna-os/bluefin-cli#524). Used by Utah.
- Upstream release deb/rpm (goreleaser nfpm,
/usr/bin/bluefin-cli) — Common's Containerfile could fetch and verify it againstchecksums.txt, like it builds uwelcome today. - Homebrew (
tuna-os/tap/bluefin-cli) — fine for users, but image shell defaults should not depend on brew having run.
Packaged installs under /usr/bin no longer try to self-update (tuna-os/bluefin-cli#522), and the init cache is keyed on version so image updates with fixed mtimes take effect (tuna-os/bluefin-cli#521).
Proposal only; no Common PR yet.
Activity
mergeraptor commentedon Nov 20, 2026
Issue triage
Next action: a triager or maintainer reviews this issue.
Reporter or contributor
kind/*label is set, categorize the issue with one of:/kind bug,/kind regression,/kind security,/kind feature,/kind documentationor/kind cleanup./area <area>if this repository supports area labels; use a value from its label list.Triager or maintainer
/triage accepted. Only triagers and maintainers can do this; acceptance does not assign an implementer.needs-kindclears when a kind is set.needs-triageand this post clear when triage is accepted.See Triage & Prow Commands for all available commands.
feat(bluefin-cli): build Utah's terminal experience from source
feat(cli): bluefin-cli runs the shell experience, uwelcome stays the …
feat(bluefin-cli): build Utah's terminal experience from source
feat(cli): bluefin-cli runs the shell experience, uwelcome stays the …
feat(bluefin-cli): build Utah's terminal experience from source
feat(cli): bluefin-cli runs the shell experience, uwelcome stays the …
feat(cli): bluefin-cli runs the shell experience, uwelcome stays the …
feat(bluefin-cli): build Utah's terminal experience from source (#1235)
feat(cli): bluefin-cli runs the shell experience, uwelcome stays the …
hanthor commentedon Nov 20, 2026
Status update: the bluefin-cli side is done, and bluefin-cli now integrates uwelcome instead of replacing it (the proposal above is updated).
Merged in tuna-os/bluefin-cli (released as v0.15.0):
/usr/bininstalls leave updates to the system package manageropenalias, bash-preexec kept armed;shell on|offremove ublue-bling's blockmotd show/togglego through uwelcome (~/.config/uwelcome/disabled), and the init scripts greet only through it, once per terminal (UWELCOME_SHOWN) and only on a terminalugis installed, fish abbreviations (BLING_USE_ABBR=0for aliases), load-once guardFactory: projectbluefin/utah-packages#1235 (
bluefin-cliRPM from the v0.15.0 tag plus its vendored modules, SHA-512-locked) — merged as dafe633 (hermetic Canary lane green: https://github.com/projectbluefin/utah-packages/actions/runs/44695312873)Utah (reference): projectbluefin/utah#1370 —
ujust bluefin-clioverride,bling.sh/bling.fish/ublue-blingshims, bling helper cleanup; uwelcome andtoggle-user-motdunchanged.bluefin-clistays in[unavailable]until a factory pin bump carries the packageOld → new
ublue-blingujust bluefin-clisource /usr/share/ublue-os/bling/bling.sh/bling.fisheval "$(bluefin-cli init <shell>)";bluefin-cli shell <shell> on|offrewrites the rc line and removes bling's blockujust bluefin-cli(ublue-bling+brew bundle --file=…/cli.Brewfile)bluefin-cli shell <shell> on+bluefin-cli install cli(oroffwhen the rc file is already managed)bluefin-cli init <shell>, per-tool toggles inbluefin-cli shell configenv.sh,bash-preexec-rearm.shprofile.d/uwelcome.sh,fish_greeting.fish,/etc/uwelcome/config.toml)ujust toggle-user-motd→uwelcome togglebluefin-cli motd toggledrivesuwelcome enable|disabletoobluefin-cli status,bluefin-cli doctor [--fix]feat(cli): bluefin-cli runs the shell experience, uwelcome stays the …
hanthor commentedon Nov 20, 2026
Utah reference landed: projectbluefin/utah#1370 merged as f72c1d4. bluefin-cli moves from
[unavailable]into Utah's install set once a factory pin bump carries the package from projectbluefin/utah-packages#1235.