shelbi review

Check a task's branch into the review work_dir and (re)launch a fresh review-claude pane there.

shelbi review

shelbi review [OPTIONS] <ID>

shelbi review is how you (or the sidebar) sit down with a worker's finished branch. It checks the task's branch into the machine's dedicated review work_dir, then spawns a fresh review-claude pane in that directory. The branch is isolated from the worker's own worktree, so reviewing doesn't interfere with the worker if you reload them onto the next task while the review pane stays open.

By default the command runs on the machine of the task's assigned_to worker. Pass --machine to override — useful when reviewing on your laptop even though the worker ran remotely.

Arguments

ArgumentTypeDefaultDescription
<ID>stringTask id to review (required).

Flags

FlagTypeDefaultDescription
--machine <MACHINE>stringtask's worker's machine, else first local machineOverride the machine to review on.
-p, --project <PROJECT>stringenv / marker fileProject to operate on.

Examples

Review a task on the same machine its worker ran on (most common — the sidebar's "Review" action runs exactly this):

shelbi review docs-write-cli-reference-pages

Pull a remote worker's branch onto your laptop for a closer look:

shelbi review docs-write-cli-reference-pages --machine laptop

See also

  • Columns — what the review column means and how a task lands in it.
  • shelbi merge — once review accepts, this is how the branch gets folded back into the default branch.