Nixbot CLI

Inspect and control nixbot CI builds with nbo. Use to find the build for a branch/PR, watch it, list failed attributes, fetch failure logs, restart or cancel builds.

Mic92 a4fad48 1.1 KB Updated

File contents

Server: NIXBOT_URL or ~/.config/nixbot/hosts.toml. In a checkout, repo and build number are inferred from origin/HEAD, override with -R [forge/]owner/name and an explicit build number.

nbo build list --branch main
nbo build view 412                           # status + failed attributes
nbo build watch 412 [--attr treefmt]         # exit 1 on failure
nbo log 412                                  # failure summary with log tails
nbo log 412 checks.x86_64-linux.foo --tail 200   # or --follow
nbo build restart 412 --attr treefmt         # token: NIXBOT_TOKEN / hosts.toml
nbo build restart 412 --effects|--effect deploy  # all or one (repeatable)
nbo build cancel 412 [--effects|--effect deploy]
nbo effects list | run default.deploy        # local, no token

Attribute and effect args accept unambiguous substrings; --json [fields] for machine-readable output. nbo auth status shows server/token. HTTP API docs at /llms.txt.

mic92/nixbot/tree/main/nixbot_cli/skill commit a4fad48a9f

Frequently asked questions

npx skillmds@latest add mic92/nixbot-cli