CLI reference

Every Commission command, its arguments, and its options — walked from the commander program itself, so this page and commission --help can never disagree.

Every command accepts --json for machine-readable output. Exit codes are the contract: 0 ok, 1 error, 2 refusal, 3 not found. A refusal is not a failure — it states what is missing and the exact command that fixes it, so an agent can act on it without a human. See Concepts and the vocabulary.

commission — the execution layer for software delivery — agents operate it, humans are asked only for judgment. Exit codes: 0 ok, 1 error, 2 refusal, 3 not found.

Commands

command	what it does
`commission init`	create a project and write .commission.json here
`commission vision`	show or set the project charter (shown to agents in every bundle)
`commission add`	add a single task (for whole graphs use ‘commission apply’)
`commission apply`	atomically create/update a whole task graph from a JSON document
`commission define`	emit the project-definition brief: idea → vision + task graph via apply
`commission next`	pick the next ready task and print its full context bundle
`commission ready`	the parallel frontier: everything workable right now, batched for safe fan-out
`commission show`	full context bundle for a task
`commission start`	begin work (auto-claims if unclaimed)
`commission review`	mark ready for review
`commission done`	complete (refused until criteria/gate evidence are satisfied)
`commission cancel`	cancel — requires -m or —superseded-by (context is preserved, never destroyed)
`commission reopen`	reopen a done/cancelled task
`commission claim`	claim a specific task for this actor (claims are leases; expired ones are reclaimable)
`commission release`	release a claim (yours or a stale one) — the lease only; ‘commission workspace release’ is what tears down the directory
`commission heartbeat`	extend your lease on a task without changing its state
`commission evidence`	attach completion evidence: commission evidence shop-12 pr=14 benchmark=https://…
`commission unevidence`	remove attached evidence by id (shown in commission show)
`commission approve`	accept a task as a human — required before done when autonomy is supervised
`commission verify`	confirm as a human that something claimed is actually true
`commission ask`	escalate a judgement call to a human instead of guessing
`commission answer`	record a human decision, and the reasoning behind it
`commission check`	tick acceptance criterion n
`commission note`	leave a session breadcrumb
`commission dep`	add a dependency
`commission undep`	remove a dependency
`commission criteria`	manage acceptance criteria (tick with ‘commission check’)
`commission link`	attach a reading-list reference
`commission unlink`	remove a link by id (shown in commission show)
`commission edit`	edit task fields
`commission workspace`	prepare, list, and release the workspace a task’s work happens in
`commission inbox`	what needs your judgment: approvals, handoffs, stale claims, divergences — with the command that clears each
`commission export`	derived markdown snapshot of the project (git-committable; DB stays the truth)
`commission standup`	brief done / doing / blocked narrative (for humans on a call)
`commission board`	project position: in-flight, ready, blocked, recent
`commission log`	append-only event feed (the catch-up query)
`commission search`	full-text search over titles, bodies, notes
`commission doctor`	self-diagnostics with exact remediation commands
`commission prime`	print the agent operating manual (paste into CLAUDE.md)
`commission dump`	full JSON export (backup / git snapshot)
`commission restore`	restore a dump into this DB (refuses to merge existing projects)
`commission list`	filtered task list (board shows position; this answers ‘which tasks match X’)
`commission context`	the committed guidance commission versions alongside the work — what it is, and what changed
`commission config`	inspect and edit .commission.json — the project’s committed configuration
`commission integrations`	show or patch a project’s sync integrations
`commission actors`	who works this project, and what each of them may claim, approve, and verify
`commission gates`	show or edit gate profiles — the evidence a task must attach before done
`commission bind`	bind a task to an external object (the trigger for all sync machinery)
`commission unbind`	remove a binding by id (shown in commission show)
`commission branch`	canonical self-identifying branch name for a task (PRs from it auto-bind)
`commission sync`	observe bound externals (PRs, Jira), canonicalize status, record divergences
`commission sync-github`	attach merged-PR evidence automatically (scans via gh CLI; matches task ids and external keys)
`commission import`	run an import adapter (available: mega-docs, jira)
`commission migrate`	apply pending database migrations, or report them with —check
`commission mcp`	start the MCP server on stdio (register: claude mcp add commission — commission mcp)
`commission serve`	start the HTTP API + human web view
`commission completions`	shell completions for bash, zsh, fish — generated from the live command tree

Global options

option	description
`-V, --version`	output the version number
`-h, --help`	display help for command

`commission init`

create a project and write .commission.json here

commission init [options] <slug>

option	description
`--name <name>`	project name
`--repo-path <path>`	path to the repository on disk (default: "<current directory>")
`--vision-file <file>`	markdown charter
`--gates <json>`	gate profiles, e.g. ’{“tier1”:[“pr”],“tier2”:[“pr”,“benchmark”,“rollback”]}’
`--no-config`	do not write .commission.json
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission vision`

show or set the project charter (shown to agents in every bundle)

commission vision [options]

option	description
`--set <text>`	set vision text
`--set-file <file>`	set vision from a markdown file
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission add`

add a single task (for whole graphs use ‘commission apply’)

commission add [options] <title>

option	description
`-p, --parent <id>`	parent task id
`-d, --dep <id>`	dependency (repeatable)
`-c, --criterion <text>`	acceptance criterion (repeatable)
`--gate <name>`	evidence gate profile
`--priority <n>`	0 (urgent) to 3 (someday), default 2
`--severity <n>`	1 (worst) to 4 — distinct from priority
`--due <date>`	ISO due date, e.g. 2026-07-25
`--autonomy <level>`	autonomous \| supervised \| human_only (default: the project’s)
`--preferred-actor <name>`	who should do this (a bias, never a lock)
`--may-execute <role>`	role or capability required to claim it (repeatable)
`--touches <glob>`	paths this task will modify (repeatable, collision hint)
`--body <text>`	markdown body
`--body-file <file>`	markdown body from file (’-’ for stdin)
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission apply`

atomically create/update a whole task graph from a JSON document

commission apply [options]

option	description
`-f, --file <file>`	document path (’-’ or omit for stdin)
`--dry-run`	validate and preview the exact result, then roll back
`--schema`	print the document JSON schema and exit
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission define`

emit the project-definition brief: idea → vision + task graph via apply

commission define [options] <slug>

option	description
`--name <name>`	project display name
`--repo-path <path>`	existing codebase on disk to ground the plan in
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission next`

pick the next ready task and print its full context bundle

commission next [options]

option	description
`--claim`	claim it atomically (recommended; parallel agents get distinct tasks)
`--lease <dur>`	claim lease duration: 30m, 2h, 1d, 0=never (default 8h)
`--any`	include tasks this actor may not claim (default: only eligible ones)
`--budget <tokens>`	trim the context bundle to fit, dropping in a documented order
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission ready`

the parallel frontier: everything workable right now, batched for safe fan-out

commission ready [options]

option	description
`--any`	include tasks this actor may not claim (default: only eligible ones)
`--as <name>`	evaluate eligibility as this actor instead of the current one
`--actor <name>`	deprecated alias for —as
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission show`

full context bundle for a task

commission show [options] <id>

option	description
`--budget <tokens>`	trim the bundle to fit, dropping in a documented order
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission start`

begin work (auto-claims if unclaimed)

commission start [options] <id>

option	description
`--force`	override refusals (requires -m; logged in the event feed)
`-m, --message <text>`	why the override is justified
`--if-version <n>`	refuse unless the task is still at this version
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission review`

mark ready for review

commission review [options] <id>

option	description
`--if-version <n>`	refuse unless the task is still at this version
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission done`

complete (refused until criteria/gate evidence are satisfied)

commission done [options] <id>

option	description
`--force`	override refusals (requires -m; logged in the event feed)
`-m, --message <text>`	why the override is justified
`--if-version <n>`	refuse unless the task is still at this version
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission cancel`

cancel — requires -m or —superseded-by (context is preserved, never destroyed)

commission cancel [options] <id>

option	description
`-m, --message <text>`	why this is being cancelled
`--superseded-by <id>`	the task that replaces this one
`--if-version <n>`	refuse unless the task is still at this version
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission reopen`

reopen a done/cancelled task

commission reopen [options] <id>

option	description
`--if-version <n>`	refuse unless the task is still at this version
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission claim`

claim a specific task for this actor (claims are leases; expired ones are reclaimable)

commission claim [options] <id>

option	description
`--lease <dur>`	lease duration: 30m, 2h, 1d, 0=never expires (default 8h)
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission release`

release a claim (yours or a stale one) — the lease only; ‘commission workspace release’ is what tears down the directory

commission release [options] <id>

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission heartbeat`

extend your lease on a task without changing its state

commission heartbeat [options] <id>

option	description
`--lease <dur>`	new lease duration: 30m, 2h, 1d, 0=never expires (default 8h)
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission evidence`

attach completion evidence: commission evidence shop-12 pr=14 benchmark=https://…

commission evidence [options] <id> <pairs...>

option	description
`--force`	attach a value Commission refuses as a placeholder (requires -m; logged)
`-m, --message <text>`	why the override is justified (required with —force)
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission unevidence`

remove attached evidence by id (shown in commission show)

commission unevidence [options] <evidenceId>

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission approve`

accept a task as a human — required before done when autonomy is supervised

commission approve [options] <id>

option	description
`-m, --message <text>`	why it is acceptable — preserved for the next session
`--role <name>`	which requirement this answers (when a task has several)
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission verify`

confirm as a human that something claimed is actually true

commission verify [options] <id>

option	description
`-m, --message <text>`	why it is acceptable — preserved for the next session
`--role <name>`	which requirement this answers (when a task has several)
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission ask`

escalate a judgement call to a human instead of guessing

commission ask [options] <id>

option	description
`-m, --message <text>`	the decision you cannot make
`--options <list>`	comma-separated choices, when you can enumerate them
`--blocking`	no agent may work this task until it is answered
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission answer`

record a human decision, and the reasoning behind it

commission answer [options] <id>

option	description
`-m, --message <text>`	the decision, and why
`--question <n>`	which open question this answers
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission check`

tick acceptance criterion n

commission check [options] <id> <n>

option	description
`--undo`	untick
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission note`

leave a session breadcrumb

commission note [options] <id>

option	description
`-m, --message <text>`
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission dep`

add a dependency

commission dep [options] <id>

option	description
`--on <depId>`	task that must finish first
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission undep`

remove a dependency

commission undep [options] <id>

option	description
`--on <depId>`	the dependency to remove
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission criteria`

manage acceptance criteria (tick with ‘commission check’)

commission criteria [options] [command]

option	description
`-h, --help`	display help for command

`commission criteria add`

append a criterion

commission criteria add [options] <id> <text...>

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission criteria edit`

rewrite criterion n

commission criteria edit [options] <id> <n> <text...>

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission criteria rm`

remove criterion n (positions re-pack)

commission criteria rm [options] <id> <n>

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission link`

attach a reading-list reference

commission link [options] <id>

option	description
`--doc <ref>`	doc path
`--url <ref>`	url
`--file <ref>`	file path
`--note <text>`	why it matters (default: "")
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission unlink`

remove a link by id (shown in commission show)

commission unlink [options] <linkId>

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission edit`

edit task fields

commission edit [options] <id>

option	description
`--title <text>`
`--body <text>`
`--body-file <file>`
`--priority <n>`
`--severity <n>`	1-4 (‘0’ clears)
`--due <date>`	ISO due date (‘none’ clears)
`--parent <id>`	set parent (‘none’ to clear)
`--assignee <name>`	who owns this task (‘none’ to clear) — distinct from a claim, which is a lease
`--gate <name>`	set gate (‘none’ to clear)
`--autonomy <level>`	autonomous \| supervised \| human_only (‘none’ to inherit)
`--preferred-actor <name>`	who should do this (‘none’ to clear)
`--may-execute <role>`	replace required roles (repeatable; empty string clears)
`--touches <glob>`	replace touches (repeatable)
`--if-version <n>`	refuse unless the task is still at this version
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission workspace`

prepare, list, and release the workspace a task’s work happens in

commission workspace [options] [command]

option	description
`-h, --help`	display help for command

`commission workspace prepare`

create or reuse a task’s workspace and print its descriptor — path, branch, env, ports

commission workspace prepare [options] <id>

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission workspace release`

tear a task’s workspace down through the same provider chain that built it

commission workspace release [options] <id>

option	description
`--force`	authorise a destructive teardown — discards uncommitted work, and drops the record even if a step failed
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission workspace list`

every prepared workspace: which task, where, and on what branch

commission workspace list [options]

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission inbox`

what needs your judgment: approvals, handoffs, stale claims, divergences — with the command that clears each

commission inbox [options]

option	description
`--actor <name>`	whose inbox (default: the resolved actor)
`--all`	every actor’s items, not just yours
`--limit <n>`	maximum items (default 25)
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission export`

derived markdown snapshot of the project (git-committable; DB stays the truth)

commission export [options]

option	description
`--out <file>`	write to a file instead of stdout
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission standup`

brief done / doing / blocked narrative (for humans on a call)

commission standup [options]

option	description
`--days <n>`	look-back window for done items (default 7)
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission board`

project position: in-flight, ready, blocked, recent

commission board [options]

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission log`

append-only event feed (the catch-up query)

commission log [options]

option	description
`--after <cursor>`	events after this event id — the reliable resumability cursor
`--since <iso>`	events at/after this ISO timestamp (human convenience; prefer —after)
`--last <n>`	last n events (default 30)
`--task <id>`	events for one task
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission search`

full-text search over titles, bodies, notes

commission search [options] <query...>

option	description
`--raw`	pass the query to FTS5 verbatim, syntax and all
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission doctor`

self-diagnostics with exact remediation commands

commission doctor [options]

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission prime`

print the agent operating manual (paste into CLAUDE.md)

commission prime [options]

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission dump`

full JSON export (backup / git snapshot)

commission dump [options]

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission restore`

restore a dump into this DB (refuses to merge existing projects)

commission restore [options]

option	description
`-f, --file <file>`
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission list`

filtered task list (board shows position; this answers ‘which tasks match X’)

commission list [options]

option	description
`--status <status>`	open, in_progress, in_review, done, cancelled (repeatable)
`--actor <name>`	tasks this actor holds a claim on or owns (assignee)
`--gate <name>`	tasks carrying this gate profile
`--sprint <name>`	tasks in this sprint
`--due <date>`	tasks due on or before this ISO date
`--parent <id>`	children of this task
`--limit <n>`	maximum rows (default 50)
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission context`

the committed guidance commission versions alongside the work — what it is, and what changed

commission context [options] [command]

option	description
`-h, --help`	display help for command

`commission context show`

every tracked guidance file with its hash and when commission last saw it, plus the project fingerprint

commission context show [options]

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission context status`

deprecated alias for ‘commission context show’ — ‘status’ means a task’s lifecycle state

commission context status [options]

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission context diff`

what guidance changed since a fingerprint — added, changed, removed (default: what you claimed under)

commission context diff [options] [fingerprint]

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission config`

inspect and edit .commission.json — the project’s committed configuration

commission config [options] [command]

option	description
`-h, --help`	display help for command

`commission config show`

the fully merged, effective configuration

commission config show [options]

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission config validate`

check a config file — exit 0 if valid, 2 if not (use it in CI)

commission config validate [options] [file]

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission config explain`

the value, the layer that set it, and every layer it overrode

commission config explain [options] <key>

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission config init`

write a minimal .commission.json for this repo

commission config init [options] [slug]

option	description
`--force`	overwrite an existing config
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission config migrate`

bring a pre-versioned config up to version 1

commission config migrate [options] [file]

option	description
`--write`	apply the migration (default: show the diff and change nothing)
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission config path`

every config path commission considered, in order

commission config path [options]

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission integrations`

show or patch a project’s sync integrations

commission integrations [options]

option	description
`--auto-close-on-merge <bool>`	close tasks when their PR merges (gates still apply)
`--add-repo <owner/name>`	register a GitHub repo for this project
`--jira-url <url>`	Jira base URL
`--jira-field <k=v>`	custom-field id, e.g. severity=customfield_10042 (repeatable)
`--jira-status <commission=Name>`	status vocabulary, e.g. in_review=Awaiting QA (repeatable; used both directions)
`--selection <keys>`	ordered policy, e.g. severity,sprint,due,priority,rank,age
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission actors`

who works this project, and what each of them may claim, approve, and verify

commission actors [options] [command]

option	description
`--all`	include actors seen in the log that nobody declared
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission actors add`

declare an actor in this repo’s config, so Commission knows who may approve and verify

commission actors add [options] <name>

option	description
`--human`	a person: may approve, verify, and answer
`--agent`	a process: may claim and work, never approve
`--role <name>`	a role they hold, e.g. owner or approver (repeatable)
`--capability <name>`	something they can do, e.g. implement or review (repeatable)
`--me`	declare the identity this command is running as
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission gates`

show or edit gate profiles — the evidence a task must attach before done

commission gates [options]

option	description
`--set <name=kinds>`	define a profile, e.g. shipped=test,commit (repeatable)
`--rm <name>`	remove a profile (repeatable)
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission bind`

bind a task to an external object (the trigger for all sync machinery)

commission bind [options] <id>

option	description
`--jira <key>`	Jira issue key, e.g. RTB-543
`--pr <ref>`	GitHub PR, owner/repo#number
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission unbind`

remove a binding by id (shown in commission show)

commission unbind [options] <bindingId>

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission branch`

canonical self-identifying branch name for a task (PRs from it auto-bind)

commission branch [options] <id>

option	description
`--checkout`	git checkout -b it in the current repo
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission sync`

observe bound externals (PRs, Jira), canonicalize status, record divergences

commission sync [options] [command]

option	description
`--from-file <file>`	jira observations from a saved search export (Rovo/REST envelope)
`--plan`	print only the outbound plan as JSON (for agent execution via MCP)
`--push`	execute the outbound plan via the built-in Jira REST executor (needs JIRA_* env)
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission sync accept`

side with the external claim: move commission to match the observed state

commission sync accept [options] <bindingId>

option	description
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission sync-github`

attach merged-PR evidence automatically (scans via gh CLI; matches task ids and external keys)

commission sync-github [options]

option	description
`--repo <owner/name>`	repo to scan (default: gh inference from the project’s repo path)
`--limit <n>`	merged PRs to scan (default 30)
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission import`

run an import adapter (available: mega-docs, jira)

commission import [options] <adapter> [path]

option	description
`--slug <slug>`	target project slug
`--name <name>`	project display name (used when the project is first created)
`--jql <jql>`	jira: JQL query (default: your open issues + last 14d of done)
`--from-file <file>`	jira: use a saved search-response JSON instead of the API
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

`commission migrate`

apply pending database migrations, or report them with —check

commission migrate [options]

option	description
`--json`	machine-readable output
`--check`	report pending migrations without applying any; exits 2 unless the database is at this binary’s schema level
`--db <path>`	database file (default: $COMMISSION_DB, else ~/.commission/commission.db)
`-h, --help`	display help for command

`commission mcp`

start the MCP server on stdio (register: claude mcp add commission — commission mcp)

commission mcp [options]

option	description
`-h, --help`	display help for command

`commission serve`

start the HTTP API + human web view

commission serve [options]

option	description
`--port <n>`	port
`--sync <dur>`	background sync interval (e.g. 5m, 1h; pull-only — plans logged, never pushed)
`-h, --help`	display help for command

`commission completions`

shell completions for bash, zsh, fish — generated from the live command tree

commission completions [options] <shell>

option	description
`--install-command`	print where to put it instead of printing the completions
`--json`	machine-readable output
`--project <slug>`	project (default: .commission.json, or the only project)
`-h, --help`	display help for command

This page is docs/reference/cli.md in the Commission repository, rendered in place — the site keeps no copy of it. It is generated by scripts/generate-docs.ts, so it is exhaustive, and editing it by hand is reverted by the next run.