CLI

Connect this terminal: shows a code, opens Motir, waits for your approval.

--server <url>

Server base URL, e.g. https://app.motir.co

--no-browser

Do not launch a browser — just print the code and the URL to open anywhere.

Disconnect this terminal: remove the stored token for a server.

--server <url>

Server to log out of (defaults to the linked / single server).

Authenticate to a Motir server with a PAT.

Validate and store a personal access token for a server.

--server <url>

Server base URL, e.g. https://app.motir.co

--token <pat>

Personal access token (or set MOTIR_TOKEN; prompted if omitted).

Show the resolved server, token prefix, and owning user.

--server <url>

Server to report (defaults to the linked / single server).

Remove the stored token for a server.

--server <url>

Server to log out of (defaults to the linked / single server).

Bind this workspace-root folder to a project, and clone the repositories it is missing.

--server <url>

Server base URL (defaults to the existing link / single server).

--workspace <slug>

Workspace slug (defaults to the token’s active workspace).

--project <key>

Project key, e.g. ACME. Omit it and the workspace’s only project is used.

--repo <name>

Mark THIS directory as a single repo’s checkout (writes a "." override).

--no-clone

Bind only — do not clone the project’s missing checkouts.

Add a repo checkout-path override (relative to the link root, or absolute).

Remove a repo checkout-path override.

Preflight your BYOK setup: auth, project link, agent binary, credential presence.

--agent <cmd>

Check THIS agent command instead of the configured one.

--json

Emit the check results as JSON.

List the linked project’s ready leaves, grouped under their runnable containers — or, with --parent / --bug, the other two ready lanes.

--kinds <list>

Comma-separated kinds: epic,story,task,bug,subtask.

--parent

List the runnable containers — what `motir next --parent` runs.

--bug

List the ready bugs instead of the leaves.

--assignee <id>

Filter by assignee: a user id, "me", or "unassigned".

--json

Emit the ready items as JSON.

Show the project pulse: ready / in-flight counts + the active sprint.

--json

Emit the pulse as JSON.

List the project’s sprints: state, item count, points, window.

--state <state>

Only sprints in this state: planned, active, or complete.

--json

Emit the sprint rows as JSON.

List ONE sprint’s work items (defaults to the active sprint).

--kinds <list>

Comma-separated kinds: epic,story,task,bug,subtask.

--json

Emit the sprint and its items as JSON.

Read one work item (e.g. ACME-7): fields, readiness, children, edges, body.

--json

Emit the get_work_item payload as JSON.

--activity

Also print the activity stream: comments and history, one page.

--comments

Also print the comment threads only, one page.

Open a work item (e.g. ACME-7) in the browser; prints the URL.

--print

Print the URL only; do not launch a browser.

Dispatch the next ready leaf (never a bug): claim it and deliver its prompt. --parent runs the next runnable container; --bug takes the next bug.

--kinds <list>

Comma-separated kinds: epic,story,task,bug,subtask.

--parent

Run the next runnable container (a story, task or bug whose children are all leaves) as a parent run — as `motir run <KEY>` would.

--bug

Take the next ready bug instead of the next leaf.

--print

Print the prompt to stdout INSTEAD of launching an agent (default). Not --print-prompt.

--print-prompt

ALSO echo the assembled prompt to stderr as it is sent, and still run the agent.

--agent <cmd>

Run THIS agent command on the prompt (overrides MOTIR_AGENT).

--reset

Clear this project’s session exclude list before picking.

--disable-log-bug

Do not let the agent file a bug for a defect it finds elsewhere; it comments instead.

--disable-replan

Do not let the agent submit a re-plan for a wrong work item; it comments and stops.

--auto-approve-replan

Not supported — approving a submitted re-plan and continuing is a `motir auto` flag.

--report-log

ALSO send your agent’s output to Motir, so a failed run shows its tail on the run page. OFF by default — only the lifecycle is sent, never file contents, paths or diffs.

Run a scope: one work item, a whole story, or `sprint` for the active one.

--print

Print the prompt to stdout INSTEAD of launching an agent (default). One item; not --print-prompt.

--print-prompt

Echo each assembled prompt to stderr as it is sent, alongside the run (2> prompts.log).

--agent <cmd>

Run THIS agent command on the prompt (overrides MOTIR_AGENT).

--force

Dispatch even though the item is not ready (dependencies unmet). One work item only.

--allow-soft-block

Run an item held only by an ancestor's block (a SOFT block). Still refuses one with its own open blocker (a HARD block — only --force passes that).

--disable-log-bug

Do not let the agent file a bug for a defect it finds elsewhere; it comments instead.

--disable-replan

Do not let the agent submit a re-plan for a wrong work item; it comments and stops.

--auto-approve-replan

Not supported — approving a submitted re-plan and continuing is a `motir auto` flag.

--max <n>

Stop after dispatching n work items from the scope.

--keep-going

Continue past a failed agent instead of halting on the first one.

--include-planning

Trigger an AI expansion for an unexpanded story instead of refusing it. Never waits: the plan needs your approval.

--kinds <list>

Not supported — a scoped run drains the whole claimed set, not a filtered subset.

--report-log

ALSO send your agent’s output to Motir, so a failed run shows its tail on the run page. OFF by default — only the lifecycle is sent, never file contents, paths or diffs.

--run-id <id>

Adopt a run Motir already opened (a hosted run) instead of opening one. Env: MOTIR_DISPATCH_RUN_ID.

Hand a work item whose pull requests are failing, whose merge could not land because of its code, or whose acceptance video was sent back to re-run, to your agent, on their own branches.

--agent <cmd>

Run THIS agent command on the fix (overrides MOTIR_AGENT).

--report-log

ALSO send your agent’s output to Motir, so a failed run shows its tail on the run page. OFF by default — only the lifecycle is sent, never file contents, paths or diffs.

Carry on a work item whose last run died, on the branch it left — from any machine, without starting it over.

--agent <cmd>

Run THIS agent command on the continue (overrides MOTIR_AGENT).

--max <n>

A parent: stop after dispatching n more work items.

--keep-going

A parent: continue past a failed agent instead of halting.

--report-log

ALSO send your agent’s output to Motir, so a failed run shows its tail on the run page. OFF by default — only the lifecycle is sent, never file contents, paths or diffs.

Hosted only: review a work item’s pull requests at the version under review and submit ONE verdict — never pushes, never posts to GitHub.

Drain the ready set unattended: one item at a time onto a session branch.

--agent <cmd>

Run THIS agent command on every prompt (overrides MOTIR_AGENT).

--kinds <list>

Comma-separated kinds: epic,story,task,bug,subtask.

--max <n>

Stop after dispatching n work items.

--keep-going

Continue past a failed agent instead of halting on the first one.

--reset

Clear this project’s session exclude list before starting.

--include-planning

Trigger an AI expansion for each unexpanded epic/story instead of skipping it. Never waits: the plan needs your approval.

--print

Not supported — an unattended loop has nobody to paste a prompt. --print-prompt IS.

--print-prompt

Echo each assembled prompt to stderr as it is sent, alongside the run (2> prompts.log).

--disable-log-bug

Do not let the agent file a bug for a defect it finds elsewhere; it comments instead.

--disable-replan

Do not let the agent submit a re-plan for a wrong work item; it comments and stops.

--auto-approve-replan

Approve a re-plan the agent submitted and keep looping, instead of stopping for you.

--report-log

ALSO send your agent’s output to Motir, so a failed run shows its tail on the run page. OFF by default — only the lifecycle is sent, never file contents, paths or diffs.

Implement a FROZEN snapshot of the ready set: one pull request per item.

--agent <cmd>

Run THIS agent command on every prompt (overrides MOTIR_AGENT).

--kinds <list>

Comma-separated kinds: epic,story,task,bug,subtask.

--max <n>

Stop after dispatching n work items.

--keep-going

Continue past a failed agent instead of halting on the first one.

--reset

Clear this project’s session exclude list before snapshotting.

--print

Not supported — a frozen snapshot has nobody to paste a prompt. --print-prompt IS.

--print-prompt

Echo each assembled prompt to stderr as it is sent, alongside the run (2> prompts.log).

--disable-log-bug

Do not let the agent file a bug for a defect it finds elsewhere; it comments instead.

--disable-replan

Do not let the agent submit a re-plan for a wrong work item; it comments and stops.

--auto-approve-replan

Not supported — approving a submitted re-plan and continuing is a `motir auto` flag.

--report-log

ALSO send your agent’s output to Motir, so a failed run shows its tail on the run page. OFF by default — only the lifecycle is sent, never file contents, paths or diffs.

Plan by talking: resume the project’s planning conversation, add turns, submit.

--detach

Submit and return with the job/plan ids; do not wait for the planner.

Close out a merged item — or a whole merged session branch.

--session <branch>

Bulk close-out: flip every item on this session branch.

--via <status>

Move through this status first (e.g. in_review).

The terminal server inside a Motir agent image.

Serve this agent’s shell to Motir’s relay over WebSocket.

--port <port>

Port to listen on, on every interface (default 7681).

Open a run session for a card in this agent’s terminal server, and return its id at once.

--run-id <id>

The run to open a session for (its credentials are read on stdin).

Stop a run’s session: SIGTERM, then SIGKILL after 10 seconds.

--run-id <id>

The run whose session to stop.

Report whether a run’s session is running, or how it exited.

--run-id <id>

The run whose session to report.

Print whether this agent’s coding agent is signed in, as JSON.

--json

Print JSON (the only format; accepted for scripts that ask for it).

Show help for a command, or read a help topic.