# 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.

- Skill: `mic92/nixbot-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mic92/nixbot-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mic92/nixbot-cli/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Mic92 (https://skillmd.com/u/mic92)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mic92/nixbot-cli

---


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.

```bash
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`.