ujust

name	ujust
description	Discover and run ujust task-runner recipes — Bluefin's primary interface for system automation.
domain	sysadmin

ujust

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.

When to Use

• Running any Bluefin-specific automation task (updates, dev setup, hardware enrollment)
• Discovering what automation is available on this specific image
• Getting help on a specific recipe before running it

When NOT to Use

• Installing GUI apps — use flatpak install or Bazaar instead
• Installing CLI tools — use brew install instead
• Running containers — use distrobox directly

Discover What's Available

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

• System: updates, rollback, power management, logs
• Apps: install curated app bundles and CLI environments
• DX (DX variant only): developer group permissions, devcontainer setup
• Troubleshooting: hardware enrollment, boot diagnostics

Get Help on a Recipe

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

Run a Recipe

ujust <recipe-name>

# Example: trigger a manual system update
ujust update

# Example: open the rebase helper for switching image variants
ujust rebase-helper

Key Recipe Categories

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.

When ujust Fails

# 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

ujust vs Other Tools

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)