Skip to content

Proposal: bluefin-cli owns the CLI experience (replace ublue-bling, bling.sh and uwelcome's terminal greeting) #1719

Open

Description

@hanthor

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: keep bling.sh/bling.fish as shims that run eval "$(bluefin-cli init <shell>)" (guarded by command -v bluefin-cli). Users keep a working shell with no action; the next bluefin-cli shell … on|off rewrites the line.
  • ublue-bling command: keep as a one-line shim to ujust 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.sh and bash-preexec-rearm.sh were read only by bling.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

  1. 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.
  2. Upstream release deb/rpm (goreleaser nfpm, /usr/bin/bluefin-cli) — Common's Containerfile could fetch and verify it against checksums.txt, like it builds uwelcome today.
  3. 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

  1. added
    needs-kindA maintainer must classify this issue; the intake source did not establish its kind.
    on Nov 20, 2026
  2. mergeraptor commented on Nov 20, 2026

    @mergeraptor
    Contributor

    Issue triage

    Next action: a triager or maintainer reviews this issue.

    Reporter or contributor

    • If no kind/* label is set, categorize the issue with one of: /kind bug, /kind regression, /kind security, /kind feature, /kind documentation or /kind cleanup.
    • Optionally add an area with /area <area> if this repository supports area labels; use a value from its label list.

    Triager or maintainer

    • Review the report and ask the reporter for any missing information.
    • When the scope is accepted and the issue is ready for work, comment /triage accepted. Only triagers and maintainers can do this; acceptance does not assign an implementer.

    needs-kind clears when a kind is set. needs-triage and this post clear when triage is accepted.

    See Triage & Prow Commands for all available commands.

  3. hanthor commented on Nov 20, 2026

    @hanthor
    MemberAuthor

    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):

    Factory: projectbluefin/utah-packages#1235 (bluefin-cli RPM 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-cli override, bling.sh/bling.fish/ublue-bling shims, bling helper cleanup; uwelcome and toggle-user-motd unchanged. bluefin-cli stays in [unavailable] until a factory pin bump carries the package

    Old → new

    Common / Dakota today With bluefin-cli
    ublue-bling shim → ujust bluefin-cli
    source /usr/share/ublue-os/bling/bling.sh / bling.fish shims → eval "$(bluefin-cli init <shell>)"; bluefin-cli shell <shell> on|off rewrites the rc line and removes bling's block
    ujust bluefin-cli (ublue-bling + brew bundle --file=…/cli.Brewfile) bluefin-cli shell <shell> on + bluefin-cli install cli (or off when the rc file is already managed)
    bling's eza/ugrep/bat aliases, direnv, starship, zoxide, mise, bash-preexec re-arm bluefin-cli init <shell>, per-tool toggles in bluefin-cli shell config
    env.sh, bash-preexec-rearm.sh not needed (bluefin-cli keeps bash-preexec armed itself)
    uwelcome greeting (profile.d/uwelcome.sh, fish_greeting.fish, /etc/uwelcome/config.toml) unchanged; bluefin-cli greets through it and never twice
    ujust toggle-user-motd → uwelcome toggle unchanged; bluefin-cli motd toggle drives uwelcome enable|disable too
    — bluefin-cli status, bluefin-cli doctor [--fix]
  4. hanthor commented on Nov 20, 2026

    @hanthor
    MemberAuthor

    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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs-kindA maintainer must classify this issue; the intake source did not establish its kind.needs-triagestage/015-triage-neededActionable but held by the reporter-trust gate: awaiting a maintainer's triage label

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions