Commands

Every xiv command, what it does, and when to reach for it. Run any command with -h for the current flags — the tables on the detail pages mirror the CLI, but the CLI is the authority.

All workflow-launching commands run against the repo you invoke them from (SMITHERS_TARGET_CWD), with runtime state in SMITHERS_HOME (default ~/.smithers). Run them from inside the target repo, not from the xiv repo.

Setup

Command	Purpose
`xiv init`	Install the managed workflow pack into `SMITHERS_HOME` and this repo's skills into your agent directories. See Getting Started.
`xiv update`	Update managed pack files (backing up local drift before overwrite) and reinstall skills. `--no-skills` on either for the pack alone.
`xiv how-to`	Print the orchestration runbook: how to drive a Linear feature to completion with `xiv stack`.

Single issue

Command	Purpose
`xiv implement`	Implement a Linear issue on a dedicated branch — plan, implement, validate, review. Local only; no PR.
`xiv ship`	Everything `implement` does, then open a PR and settle its CI and human review comments.

Pull requests

Command	Purpose
`xiv pr review`	Review a remote PR in an isolated worktree, then interactively select findings and submit. Never merges.
`xiv pr fix`	Address the existing review findings on a PR once and push — no loop, nothing posted back.
`xiv pr refine`	Settle a PR against CI and human review comments: fix what they raise and push. Never merges.

Stacked features

Command	Purpose
`xiv stack init`	One-time per repo: colocate jj alongside git.
`xiv stack plan`	Turn a Linear project or parent issue into an ordered stack map, or persist a resolved `--plan` file.
`xiv stack build`	Build entries locally, bottom to top. Resumable.
`xiv stack status`	Print the stack map: positions, statuses, branches, PRs.
`xiv stack triage`	Compact next-action report for operating the stack. Start here.
`xiv stack preview`	Check out every repo at its stack tip to preview the whole feature.
`xiv stack push`	Publish the next N built entries as stacked PRs and re-sync re-flowed open PRs.
`xiv stack review`	Settle the open stacked PRs against CI and human comments. Never merges.
`xiv stack amend`	Apply a change to one entry and re-flow it through its descendants.

Workflow authoring

Command	Purpose
`xiv dev`	Run a workflow straight from the repo's `pack/` — the fast authoring loop, no install round-trip.
`xiv check`	Render a workflow's graph from the repo's `pack/` without executing it.

Operations

Command	Purpose
`xiv ps`	Forward to `smithers ps`: what's running right now.
`xiv logs`	Forward to `smithers logs`: run output, step progress, failures.
`xiv ui`	Forward to `smithers ui`: live workflow graph in the browser.
`xiv inspect`	Forward to `smithers inspect`: detailed state for one run.
`xiv cancel`	Forward to `smithers cancel`: cancel one specific run.
`xiv down`	Cancel ALL active/orphaned runs (like `docker compose down`).
`xiv panic`	Alias for `xiv down` — the credit-burn kill switch. Kill everything now, diagnose after.

For what these commands launch under the hood, see Workflows. For how runs behave and resume, see How It Works.

Suggest changes to this page