Menü
Discover and run ujust task-runner recipes — Bluefin's primary interface for system automation.
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
| name | ujust |
| description | Discover and run ujust task-runner recipes — Bluefin's primary interface for system automation. |
| domain | sysadmin |
ujust is Bluefin's task runner, built on just.
It exposes a curated set of system automation recipes for updates, developer setup,
hardware configuration, and more. Recipes vary by image variant (base, DX, NVIDIA, Aurora)
and stream (GTS/Latest).
Load with: point your agent at this file.
flatpak install or Bazaar insteadbrew install insteaddistrobox directlyAlways start by discovering — never assume a recipe exists:
# List all available recipes on this system
ujust
# or
ujust --list
Recipes are grouped by category. Categories vary by variant but typically include:
Before running an unfamiliar recipe, inspect it:
# Show the source of a recipe (what it actually runs)
ujust --show <recipe-name>
# Some recipes accept --help
ujust <recipe-name> --help 2>/dev/null
ujust <recipe-name>
# Example: trigger a manual system update
ujust update
# Example: open the rebase helper for switching image variants
ujust rebase-helper
Rather than memorizing recipe names, use ujust --list to discover them.
Common categories confirmed on Bluefin DX (LTS stream):
| Category | What It Does |
|---|---|
update | Pull latest OS image (applied on next reboot) |
bbrew | Install packages from a curated Brewfile |
bluefin-cli | Set up the Bluefin CLI experience (shell, tools) |
dx-group | Add docker/incus/libvirt/serial permissions (DX only) |
enroll-secure-boot-key | Enroll the Bluefin Secure Boot key |
rebase-helper | Guided rebase to a different image variant |
bios / bios-info | Access BIOS or show firmware info |
logs-this-boot / logs-last-boot | Filtered journal for current/previous boot |
powerwash | Factory reset (destructive — prompts for confirmation) |
⚠️ Recipe availability depends on your image variant and stream. Always verify with
ujust --list.
# Recipe not found
ujust --list | grep <partial-name> # check spelling and availability
# Permission error
# Some recipes use pkexec (GUI sudo prompt) — authenticate when prompted
# Recipe exists but errors out
ujust --show <recipe-name> # read the source to understand dependencies
journalctl -b -p err | tail -20 # check for related system errors
| Need | Tool |
|---|---|
| Install a GUI app | flatpak install flathub <id> |
| Install a CLI tool | brew install <formula> |
| Run a Linux distro container | distrobox create / enter |
| System automation (Bluefin-specific) | ujust <recipe> |
| OS image update | ujust update (wraps bootc) |
Create, enter, and manage Distrobox containers for mutable package installation on Bluefin.
ZFS administration on Bluefin — pools, datasets, snapshots, and delivery options for an immutable host that does not ship ZFS kernel modules.
Run, build, and manage OCI containers rootlessly on Bluefin — including Quadlets for persistent systemd-managed services.
Run self-hosted services on Bluefin DX using Podman Quadlets and linuxserver.io containers — persistent, auto-updating, systemd-managed.
Install and manage CLI tools with Homebrew — the primary CLI package manager on Bluefin.
Manage GNOME extensions, gsettings, and desktop customizations on Bluefin — including which settings Bluefin owns vs. which are safe to change.