assist backlog

These work on the current repo’s backlog. Item ids are written a555; commands also accept 555.

Viewing

assist backlog (or assist backlog web) opens the Backlog tab in the dashboard. --port <number> picks the port (default 3100) and --no-open skips opening a browser.
assist backlog list (alias ls, also assist list) lists open items. --status <status> filters by status, --all includes done and won’t-do items, --all-repos lists every repo’s items and --verbose shows each item in full.
assist backlog search <query> finds items by keyword.
assist backlog show <id> (alias view) prints an item in full. --all-commits lists every commit in its activity rather than the newest 10.
assist backlog plan <id> prints just its plan, and assist backlog comments <id> just its comments.

assist backlog add internal adds an item from --name, --type <story|bug>, --desc and --ac <criterion> (repeatable). Called by agents working on backlog items.
assist backlog update-field <id> internal changes --name, --desc or --type. --ac replaces every acceptance criterion, while --add-ac <text>, --edit-ac <n> <text> and --remove-ac <n> change one. --origin [origin] moves the item to another repo. Called by /refine.
assist backlog add-phase <id> <name> --task <task> internal adds a phase, with --manual-check <check> (both repeatable) and --position <n>. Called by agents working on backlog items.
assist backlog update-phase <id> <phase> internal (alias edit-phase) changes a phase’s --name, --task and --manual-check lists, or one task or check with --add-task, --edit-task <n>, --remove-task <n>, --add-check, --edit-check <n> and --remove-check <n>. Called by agents working on backlog items.
assist backlog remove-phase <id> <phase> internal removes a phase. Called by agents working on backlog items.
assist backlog move-phase <id> <from> <to> internal moves a phase. Called by agents working on backlog items.
assist backlog update-plan <id> --json <file|-> internal replaces the whole plan from a JSON payload, after approval in a dashboard session. Called by /refine.

assist backlog start <id> internal sets an item in progress. Called by agents working on backlog items.
assist backlog stop internal puts every in-progress item back to todo at its first phase. Called by agents working on backlog items.
assist backlog done <id> [summary] internal marks an item done. Called by the review phase of a backlog run.
assist backlog wontdo <id> [reason] internal marks an item won’t do. Called by agents working on backlog items.
assist backlog set-status <id> <todo|in-progress|done|wontdo> internal sets any status. Called by agents working on backlog items.
assist backlog star <id> internal stars an item. Called by agents working on backlog items.
assist backlog unstar <id> internal unstars an item. Called by agents working on backlog items.
assist backlog delete <id> internal (alias remove) deletes an item. Called by agents working on backlog items.

assist backlog comment <id> <text> internal adds a comment. Called by backlog run phases and /refine.
assist backlog delete-comment <id> <comment-id> internal deletes a comment other than a phase summary. Called by agents working on backlog items.
assist backlog link <from> <to> internal links two items, --type depends-on making <from> wait for <to> (default relates-to). Called by agents working on backlog items.
assist backlog unlink <from> <to> internal removes a link. Called by agents working on backlog items.
assist backlog associate-jira <id> [key] internal links a Jira issue by key or browse URL, replacing any GitHub issue; --clear removes it. Called by /draft, /bug and /refine.
assist backlog associate-github <id> [issue] internal links a GitHub issue by URL or owner/repo#number, replacing any Jira issue; --clear removes it. Called by /draft, /bug and /refine.
assist backlog add-activity <id> <branch|commit|pr|slack|session|design> <ref> internal attaches a ref to an item’s activity, with --title, --url and --state. Called by /draft, /bug and /refine.
assist backlog record-slack <url> internal attaches a Slack thread to the current session’s item. Called by /prs-slack.

assist next [id] (or assist backlog next) runs the item already in progress, or one you pick, then offers the next. With [id] it runs that item first; with no items left it starts /draft. --once stops after one item. In a terminal started by assist next, assist draft, assist bug or assist refine, /next [id] ends the current session and moves on to item <id>, or to whatever assist next picks.
assist backlog run <id> internal runs an item’s plan from the phase it is on. --harness <claude|codex|pi> overrides harness.engine, and --no-write runs the harness without write access. Called by the dashboard’s Build and assist next.
assist backlog refine [id] internal is the same as assist refine. Called by agents working on backlog items.
assist backlog rewind <id> <phase> --reason <reason> internal sends an item back to an earlier phase. Called by the review phase of a backlog run.
assist backlog phase-done <id> <phase> <summary> internal marks a phase complete and records its summary. Called by the agent running each phase of a backlog run.

assist backlog clone <origin> clones an item’s repo over SSH into clone.baseDir.
assist backlog refresh-docs queues a Refresh docs story now for every done story no refresh covers yet, whatever docs.refreshAfter is set to.
assist docs unlock internal lets the current phase of a backlog run edit docs pages and screenshots, which are otherwise left to Refresh docs, once you approve. It sends you a pin as a desktop notification. Called by agents whose docs edit was blocked.
assist docs confirm <pin> internal approves that unlock with the pin from the notification. Called by agents whose docs edit was blocked, once you give them the pin.
assist backlog move-repo <old-origin> [new-origin] moves every item from one repo to another after a rename, the current repo when no new origin is given. --yes skips the prompt.
assist backlog export [file] writes the whole backlog database to a file, or stdout, and assist backlog import [file] replaces the database with an export, from stdin when no file is given. --yes skips the prompt.