CLI command reference

Every archdev command, its arguments, and its flags, generated from the CLI.

Every command below is generated from the ArchDev CLI's own help text, so it matches the release you have installed. Regenerate it with pnpm --dir src/ts/archdev docs:cli-reference.

Two flags work everywhere: --profile <name> selects a settings and credentials profile, and --json emits JSON where the command supports it. Run any command with --help for the same text in your terminal. Entries marked Deprecated still run but print their replacement; prefer the replacement in scripts.

archdev auth

Manage authentication

archdev auth

archdev auth login

Authenticate via browser, copy/paste, or a personal access token

archdev auth login [email] [options]
Argument Description
[email] Optional email hint for the login page
Flag Description Default
-s, --server <url> API server URL
--email <address> Pre-fill email address on the login page
--token <token> Personal access token (skips the browser)
--headless Use the copy/paste flow instead of opening a local browser

archdev auth logout

Remove stored credentials

archdev auth logout

archdev auth status

Show current authentication status

archdev auth status

archdev setup

Authenticate and initialize this repository; asks before installing the daemon

archdev setup [options]
Flag Description Default
--skills Install skills for detected coding tools; skip auth, repository and daemon setup
--no-skills Skip the optional skills installer during full setup
--no-agent Keep the generated defaults without an agent proposal
--agent Generate a model proposal, including for an existing archdev.json
--provider <provider> Choose archdev, openai, or xai without the interactive wizard
--provider-email <email> Provider account email for non-interactive OpenAI or xAI setup
--device-code Log in to OpenAI or xAI with device-code OAuth (SSH / remote browser)
--pr-tracking-scope <scope> Track all-authored or factory-only pull requests
--yes Confirm model-generated pipelines; with --skills, accept skills install prompts

archdev settings

Manage CLI configuration

archdev settings

archdev settings set

Set a configuration value

archdev settings set

archdev settings set api-url

Set the API base URL (default: https://platform.archastro.ai)

archdev settings set api-url <url>
Argument Description
<url> API base URL to store

archdev settings set portal-url

Set the portal URL for authentication (default: https://archdev.ai)

archdev settings set portal-url <url>
Argument Description
<url> Portal URL to store

archdev settings unset

Clear a configuration value so the default applies

archdev settings unset

archdev settings unset api-url

Restore the API base URL default (https://platform.archastro.ai)

archdev settings unset api-url

archdev settings unset portal-url

Restore the portal URL default (https://archdev.ai)

archdev settings unset portal-url

archdev settings get

Get configuration values

archdev settings get

archdev settings get app

Get the default app ID

archdev settings get app

archdev settings get api-url

Get the API base URL

archdev settings get api-url

archdev settings get portal-url

Get the portal URL for authentication

archdev settings get portal-url

archdev settings reset

Reset all configuration to defaults

archdev settings reset

archdev settings path

Show config file location

archdev settings path

archdev settings provider

Manage ArchDev model providers (ChatGPT / Grok subscriptions or API keys)

archdev settings provider

archdev settings provider list

List model providers and authentication status

archdev settings provider list

archdev settings provider status

Show detailed authentication status for model providers

archdev settings provider status

archdev settings provider usage

Show subscription usage for every ChatGPT and Grok account ArchDev tracks

archdev settings provider usage

archdev settings provider models

List models available from a provider

archdev settings provider models <provider>
Argument Description
<provider> platform, openai, or xai

archdev settings provider login

Log in to a model provider (OAuth by default)

archdev settings provider login <provider> [options]
Argument Description
<provider> openai or xai
Flag Description Default
--api-key <key> Store an API key instead of OAuth
--device-code Use device-code OAuth (SSH / headless friendly)
--account <email> Log in one email instead of the saved list

archdev settings provider logout

Remove stored credentials for a provider

archdev settings provider logout <provider>
Argument Description
<provider> openai or xai

archdev settings provider accounts

List or edit BYO login emails in ~/.archdev/archdev.json

archdev settings provider accounts <provider> [action] [email]
Argument Description
<provider> openai or xai
[action] list, add, remove, or reset
[email] Login email for add or remove

archdev run

Start ArchDev as a software factory

archdev run [options]
Flag Description Default
--factory Run the interactive TUI as a software factory true
--workers <n> Factory worker subprocesses (1-32) 3
--dispatch <mode> Factory task dispatch: auto claims every ready task; manual claims only tasks you release
--autonomy <mode> Factory overseer autonomy: confirm (default) or auto for evidence-backed unblocking
--resume <session> Resume a saved ArchDev session id
-p, --print <prompt> Run one prompt non-interactively and print the result, then exit
--review <workflow> Run a review workflow from .archdev/reviews non-interactively
--workflow <workflow> Run a workflow from .archdev/workflows non-interactively
--workflow-input <text> Invocation input exposed to workflow prompts as {{input}}
--review-target <target> Diff to review: current-files or branch-commits
--output-format <format> With --print, --review, or --workflow, the output format: text or json "text"
--model <id> Model id to run with
--max-turns <n> With --print, the maximum agent turns before stopping
--permission-mode <mode> With --print, set the headless agent permission mode
--stream With --print, stream transcript events as NDJSON on stdout and read steering messages from stdin (implies JSON output)
--image <prompt> Generate an image non-interactively from the supplied prompt
--image-model <id> Image model id; omit for the platform default
--image-list-models List the available image models and exit
--image-options List every image generation option and exit
--image-output-format <format> Shape of image stdout: text or json
--image-output-dir <dir> Directory to write the generated images into (created if missing) "."
--image-count <n> Number of images to generate, one request each (max 10) 1
--image-filename <name> Base filename to write (extension added when absent); defaults to a slug of the prompt
--image-overwrite Replace an existing file instead of picking the next free name false
--image-input <path> Source image to edit (repeatable). Sends the file to the image-edits API instead of generating from scratch
--image-aspect-ratio <ratio> Aspect ratio, e.g. "1:1" or "16:9"
--image-dimensions <WxH> Output dimensions, e.g. "1024x1024"
--image-size <tier> Resolution tier, e.g. "1K", "2K", "4K"
--image-width <px> Output width in pixels
--image-height <px> Output height in pixels
--image-quality <quality> Quality preset (model-dependent)
--image-style <style> Style preset (model-dependent)
--image-background <background> Background treatment (model-dependent)
--image-format <format> Image file format to request: png, jpeg, or webp

archdev tasks

Plan, claim, and complete shared work (no daemon required)

Aliases: task

archdev tasks [options]
Flag Description Default
--skill Deprecated alias for tasks guide

archdev tasks review

Review and revise task plans in one browser session

archdev tasks review

archdev tasks review start

Open a plan review and stream JSONL feedback until stopped

archdev tasks review start [options]
Flag Description Default
--file <path> Preview graph JSON, with optional major_decisions
--session-file <path> Write the private session handle to this new file
--team <id> Save Tasks to this team; defaults to your personal tasks
--repository <owner/repo> Associate saved Tasks with this repository
--state-file <path> Durable task-ID receipt; defaults to a private file for this plan path
--no-open Print the URL without opening the browser

archdev tasks review update

Publish a revised plan into the open browser session

archdev tasks review update <session-file> [options]
Argument Description
<session-file> Private session handle file from review start
Flag Description Default
--file <path> Revised preview graph JSON
--revision <number> Expected current revision from status or feedback

archdev tasks review status

Read the current plan and approval status

archdev tasks review status <session-file>
Argument Description
<session-file> Private session handle file from review start

archdev tasks review feedback

Read review events without consuming them

archdev tasks review feedback <session-file> [options]
Argument Description
<session-file> Private session handle file from review start
Flag Description Default
--after <sequence> Read events after this sequence "0"

archdev tasks review stop

Close the local review session

archdev tasks review stop <session-file>
Argument Description
<session-file> Private session handle file from review start

archdev tasks guide

Print instructions for agents working with shared tasks

archdev tasks guide

archdev tasks graph

Inspect and import dependency-aware task graphs

archdev tasks graph

archdev tasks graph schema

Print the task graph JSON schema

archdev tasks graph schema

archdev tasks graph import

Validate and create a task DAG from JSON

archdev tasks graph import [options]
Flag Description Default
--file <path> Task graph JSON file

archdev tasks list

List tasks

archdev tasks list [options]
Flag Description Default
--team <id> Team that owns the tasks
--user <id> User that owns the tasks; defaults to me
--org <id> Organization that owns the tasks
--status <status> Filter by open, in_progress, in_review, paused, failed, superseding, done, cancelled
--owner-user <id> Filter by assigned user
--owner-agent <id> Filter by assigned agent
--priority <n> Filter by priority 0-4
--tag <tag> Filter by tag
--parent <id> Filter by parent task, or none for top-level
--source-scope <scope> Filter by source container
--source-type <type> Filter by source object kind
--source-id <id> Filter by source object identity
--epic <epic> Filter by epic label
--sort <field> Sort by created, due_date, or priority
--order <direction> Sort ascending or descending
--due-before <date> Only tasks due before this ISO date
--due-after <date> Only tasks due after this ISO date
--overdue Only unfinished overdue tasks
--ready Only open, unblocked tasks without an active lease
--limit <count> Maximum tasks to return
--after-cursor <cursor> Continue from a prior page
--room <id> List job-marked tasks owned by this room
--include-completed Include completed room tasks when --room is used

Search task names and descriptions

archdev tasks search <query> [options]
Argument Description
<query> Search text matched against task names and descriptions
Flag Description Default
--team <id> Team that owns the tasks
--user <id> User that owns the tasks; defaults to me
--org <id> Organization that owns the tasks
--status <status> Filter by open, in_progress, in_review, paused, failed, superseding, done, cancelled
--owner-user <id> Filter by assigned user
--owner-agent <id> Filter by assigned agent
--priority <n> Filter by priority 0-4
--tag <tag> Filter by tag
--parent <id> Filter by parent task, or none for top-level
--source-scope <scope> Filter by source container
--source-type <type> Filter by source object kind
--source-id <id> Filter by source object identity
--epic <epic> Filter by epic label
--sort <field> Sort by created, due_date, or priority
--order <direction> Sort ascending or descending
--due-before <date> Only tasks due before this ISO date
--due-after <date> Only tasks due after this ISO date
--overdue Only unfinished overdue tasks
--ready Only open, unblocked tasks without an active lease
--limit <count> Maximum tasks to return
--after-cursor <cursor> Continue from a prior page

archdev tasks ready

List unblocked, unleased open tasks

archdev tasks ready [options]
Flag Description Default
--explain Include blocked and leased tasks with a reason
--source-scope <scope> Filter by source container
--source-type <type> Filter by source object kind
--source-id <id> Filter by source object identity
--epic <epic> Filter by epic label
--limit <count> Maximum tasks to return
--after-cursor <cursor> Continue from a prior page
--team <id> Team that owns the tasks
--user <id> User that owns the tasks; defaults to me
--org <id> Organization that owns the tasks

archdev tasks blocked

List blocked unfinished tasks

archdev tasks blocked [options]
Flag Description Default
--team <id> Team that owns the tasks
--user <id> User that owns the tasks; defaults to me
--org <id> Organization that owns the tasks

archdev tasks show

Show one task

archdev tasks show <task-id> [options]
Argument Description
<task-id> ID of the task to show
Flag Description Default
--team <id> Team that owns the tasks
--user <id> User that owns the tasks; defaults to me
--org <id> Organization that owns the tasks

archdev tasks create

Create a task

archdev tasks create <name> [options]
Argument Description
<name> Name for the new task
Flag Description Default
--description <text> Long-form description
--priority <n> Priority 0-4
--due-date <date> Due date in ISO 8601 format
--owner-user <id> Assign to a user
--owner-agent <id> Assign to an agent
--parent <id> Create under a parent task
--tag <tag> Tag; repeatable
--source-scope <scope> Source container
--source-type <type> Source object kind
--source-id <id> Source object identity
--epic <epic> Grouping label
--room <id> Create an up-for-grabs task in this room
--kind <kind> Room task cadence: once, hourly, daily, weekly, or monthly
--team <id> Team that owns the tasks
--user <id> User that owns the tasks; defaults to me
--org <id> Organization that owns the tasks

archdev tasks update

Update task fields

archdev tasks update <task-id> [options]
Argument Description
<task-id> ID of the task to update
Flag Description Default
--name <name> New task name
--description <text> New description
--status <status> New native status; does not restart execution or clear local recovery state
--priority <n> New priority 0-4
--due-date <date> New due date
--owner-user <id> Assign to a user
--owner-agent <id> Assign to an agent
--parent <id> Move under a parent
--tag <tag> Replacement tag; repeatable
--source-scope <scope> Source container
--source-type <type> Source object kind
--source-id <id> Source object identity
--epic <epic> Grouping label
--lease-id <uuid> Caller-held lease UUID
--session-id <uuid> Session UUID paired with --lease-id

archdev tasks claim

Atomically claim an assigned task for this coding session

archdev tasks claim <task-id> [options]
Argument Description
<task-id> ID of the task to claim
Flag Description Default
--session-id <uuid> Session UUID; generated when omitted
--lease-id <uuid> Lease UUID; generated when omitted
--session-name <name> Human-readable session name
--harness <name> Coding harness "archdev"
--lease-duration-seconds <seconds> Requested lease duration

archdev tasks release

Release this session's task lease

archdev tasks release <task-id> [options]
Argument Description
<task-id> ID of the task to release
Flag Description Default
--lease-id <uuid> Caller-held lease UUID
--session-id <uuid> Coding-session UUID

archdev tasks close

Mark a task done

archdev tasks close <task-id> [options]
Argument Description
<task-id> ID of the task to close
Flag Description Default
--lease-id <uuid> Caller-held lease UUID
--session-id <uuid> Session UUID paired with --lease-id
--room <id> Require the task to be a completable room task

archdev tasks reopen

Move a completed task back to open

archdev tasks reopen <task-id>
Argument Description
<task-id> ID of the task to reopen

archdev tasks comment

Add durable context to a task

archdev tasks comment <task-id> <body>
Argument Description
<task-id> ID of the task to comment on
<body> Comment text to post

Deprecated. The CLI prints the replacement at runtime. Attach files and link objects to a task: links add, links list, links download, links remove. Attachments stay explicit: automation discovers and downloads them with these commands; Factory prompt ingestion is deferred.

Aliases: link

archdev tasks links

Deprecated. The CLI prints the replacement at runtime. Link a task to an external object, or upload a local file with --file . Existing platform files attach with --type file --scope platform <fil_...>. Local files above ~5 MiB are rejected before upload.

archdev tasks links add <task-id> [target] [options]
Argument Description
<task-id> ID of the task to link
[target] URL or identifier to link; omit with --file
Flag Description Default
--type <type> Link kind; inferred from a URL target. Known: branch, commit, document, file, issue, job, pull_request, replacement_task, repository, review
--scope <scope> Container the object lives in; inferred from a URL target
--file <path> Upload a local file and link it, instead of linking
--team <id> Team that owns the uploaded file
--user <id> User that owns the uploaded file
--org <id> Organization that owns the uploaded file
--content-type <mime> MIME type for --file; inferred from the filename when omitted

Deprecated. The CLI prints the replacement at runtime. List a task's links, with file metadata for native file links

archdev tasks links list <task-id> [options]
Argument Description
<task-id> ID of the task whose links to list
Flag Description Default
--team <id> Explicit owning team for privileged calls
--user <id> Explicit owning user for privileged calls
--org <id> Explicit organization for privileged calls

Deprecated. The CLI prints the replacement at runtime. Download a native file link to disk without overwriting

archdev tasks links download <task-id> <file-id> [options]
Argument Description
<task-id> ID of the task holding the link
<file-id> ID of the linked file to download
Flag Description Default
--out <path> Output path; defaults to the stored filename
--force Overwrite an existing output file

Deprecated. The CLI prints the replacement at runtime. Remove a link from a task

archdev tasks links remove <task-id> <target> [options]
Argument Description
<task-id> ID of the task holding the link
<target> Linked URL or identifier to remove
Flag Description Default
--type <type> Link kind; inferred from a URL target
--scope <scope> Container; inferred from a URL target

archdev tasks deps

Deprecated. The CLI prints the replacement at runtime. Manage blocking dependencies

Aliases: dep

archdev tasks deps

archdev tasks deps add

Deprecated. The CLI prints the replacement at runtime. Add a blocking dependency

archdev tasks deps add <task-id> [options]
Argument Description
<task-id> ID of the task blocked by --blocked-by
Flag Description Default
--blocked-by <task-id> Task that blocks this task

archdev tasks deps remove

Deprecated. The CLI prints the replacement at runtime. Remove a blocking dependency

archdev tasks deps remove <task-id> [options]
Argument Description
<task-id> ID of the task to unblock
Flag Description Default
--blocked-by <task-id> Blocking task to remove

archdev tasks deps list

Deprecated. The CLI prints the replacement at runtime. List tasks blocking this task

archdev tasks deps list <task-id> [options]
Argument Description
<task-id> ID of the task whose blockers to list
Flag Description Default
--limit <count> Maximum blockers
--after-cursor <cursor> Continue from a prior page
--team <id> Team that owns the tasks
--user <id> User that owns the tasks; defaults to me
--org <id> Organization that owns the tasks

archdev tasks deps cycles

Deprecated. The CLI prints the replacement at runtime. Diagnose cycles in unfinished blocking dependencies

archdev tasks deps cycles [options]
Flag Description Default
--limit <count> Maximum cycle components
--after-cursor <cursor> Continue from a prior page
--team <id> Team that owns the tasks
--user <id> User that owns the tasks; defaults to me
--org <id> Organization that owns the tasks

archdev minimap

Minimap observations

archdev minimap

archdev minimap ping

Report a fresh last-observed CLI snapshot

archdev minimap ping

archdev evals

Inspect evaluation configuration (no evaluation execution)

archdev evals

archdev evals config

Resolve evaluation directory and authenticated model roles without model calls

archdev evals config [options]
Flag Description Default
--json Output schema-versioned JSON
--eval-dir <path> Repository-relative evaluation directory
--model <selector> Subject selector
--author-model <selector> Author selector
--judge-model <selector> Judge selector
--mock-model <selector> Stateful mock selector
--llm-graders Require an independent judge
--stateful-mocks Resolve the stateful mock role

archdev evals pieces

List skill, MCP, and subagent sources without starting connections

archdev evals pieces [options]
Flag Description Default
--json Output schema-versioned JSON

archdev evals init

Write an uncalibrated evaluation scaffold

archdev evals init [options]
Flag Description Default
--bare Write an uncalibrated scaffold without selecting pieces

archdev extract

List, preview, run, and show registered extractions

archdev extract

archdev extract list

List registered extractors

archdev extract list [options]
Flag Description Default
--json Output JSON

archdev extract context

Print extraction context for authoring output

archdev extract context <extractor> <ref> [options]
Argument Description
<extractor> Extractor id
<ref> Subject reference
Flag Description Default
--json Output JSON

archdev extract run

Run an extractor against a subject

archdev extract run <extractor> <ref> [options]
Argument Description
<extractor> Extractor id
<ref> Subject reference
Flag Description Default
--runner <spec> Override runner (repeatable): llm:, jev:, file:, deterministic []
--sink <spec> Override sink: object, file:, stdout []
--force Regenerate even when a cached extraction exists
--json Output JSON

archdev extract replay

Replay saved extraction input without resolving its source

archdev extract replay <extractor> [options]
Argument Description
<extractor> Extractor id and optional variant
Flag Description Default
--from <envelope-file> Saved extraction envelope
--sink <spec> Explicit output sink []
--runner <spec> Override runner (repeatable) []
--json Output JSON

archdev extract show

Read a stored extraction from the sink

archdev extract show <extractor> <ref> [options]
Argument Description
<extractor> Extractor id
<ref> Subject reference
Flag Description Default
--revision <r> Stored revision instead of the resolved head
--sink <spec> Override sink: object, file:, stdout []
--json Output JSON

archdev extract guide

Print instructions for agents authoring extractor output

archdev extract guide [options]
Flag Description Default
--json Output JSON

archdev extract brief

Print the producer kit for external-model extraction (rubric only, no model call)

archdev extract brief <definition> [options]
Argument Description
<definition> Risk definition: risk.[@]
Flag Description Default
--about <hint> Free-text note about what to assess
--out <dir> Write DEFINITION.md, schemas, and brief.json here

archdev extract finalize

Validate agent-authored {input, assessment} and seal it with the derived grade

archdev extract finalize <definition> <file> [options]
Argument Description
<definition> Risk definition: risk.[@]
<file> JSON file with {input, assessment} (or a sealed result to re-verify)
Flag Description Default
--out <dir> Write result.json and digest.txt here

archdev jobs

Run and inspect durable repository automation

archdev jobs

archdev jobs list

List recent local automation jobs

archdev jobs list

archdev jobs trigger

Create a daemon job for the current private branch

archdev jobs trigger <type> [options]
Argument Description
<type> Job type: branch_update, branch_rebase_conflict, or one_off
Flag Description Default
--payload <json> JSON payload passed to the job

archdev jobs cancel

Cancel a queued or running daemon job

archdev jobs cancel <id>
Argument Description
<id> ID of the job to cancel

archdev jobs clean

Remove terminal jobs, or all matching jobs with --all

archdev jobs clean [options]
Flag Description Default
--status <status...> Only clean these states (queued and running require --all)
--after <timestamp> Only clean jobs updated at or after this time
--before <timestamp> Only clean jobs updated at or before this time
--force Remove clean nested worktrees missing lifecycle ownership, and prune archastro/wt-* branches on the mirror with no registered worktree
--keep-rows Remove job artifacts but keep the job rows (history and reports stay queryable)
--all Stop the daemon and permanently delete matching jobs, including active jobs
--yes Confirm --all cleanup without prompting

archdev jobs retry

Retry a failed job using its snapshot or rebased branch; PR retries belong to the watcher

archdev jobs retry <id>
Argument Description
<id> ID of the failed job to retry

archdev jobs setup

Register this repository for Jobs; asks before installing the runner if it is missing

archdev jobs setup [options]
Flag Description Default
--name <name> Use a unique private repository name
--pr-tracking-scope <scope> Track all-authored or factory-only pull requests

archdev jobs workspace

Record explicit membership of initialized primary repositories

archdev jobs workspace

archdev jobs workspace init

Write archdev.workspace.json from initialized direct-child repositories

archdev jobs workspace init

archdev jobs show

Inspect job input, attempts, steps, outputs, and result

archdev jobs show <id>
Argument Description
<id> ID of the job to inspect

archdev jobs logs

Print persisted stdout and stderr, including earlier attempts

archdev jobs logs <id> [options]
Argument Description
<id> ID of the job whose logs to print
Flag Description Default
--step <id> Select one pipeline step
--attempt <number> Select one attempt

archdev jobs pr

Inspect repository-qualified PR automation

archdev jobs pr

archdev jobs pr status

Read cached watch state and proof without contacting GitHub or changing daemon state

archdev jobs pr status [number] [options]
Argument Description
[number] Pull request number; omit with --stuck to list stuck watches
Flag Description Default
--repo <repository> Repository identity (owner/name)
--stuck Show active watches missing proof, retrying, quarantined or exhausted

archdev jobs pr verify

Request one operator-authorized current-head verification

archdev jobs pr verify <number> [options]
Argument Description
<number> Pull request number
Flag Description Default
--repo <repository> Repository identity (owner/name)

archdev jobs pr settle

Request reconsideration without bypassing proof

archdev jobs pr settle <number> [options]
Argument Description
<number> Pull request number
Flag Description Default
--repo <repository> Repository identity (owner/name)

archdev jobs pr remediate

Rearm the exact current remediation incident

archdev jobs pr remediate <number> [options]
Argument Description
<number> Pull request number
Flag Description Default
--repo <repository> Repository identity (owner/name)

archdev jobs run

Run committed HEAD in an isolated worktree, or mutate this checkout with --here

archdev jobs run <pipeline> [options]
Argument Description
<pipeline> Name of the pipeline to run
Flag Description Default
--here Run immediately in this checkout without creating a durable job

archdev jobs runner

Manage the shared ArchDev local automation daemon

archdev jobs runner

archdev jobs runner install

Install the local daemon without prompting; the only silent first-install command

archdev jobs runner install [options]
Flag Description Default
--existing-only Refresh and restart an existing managed daemon without creating one

archdev jobs runner start

Start the installed local daemon

archdev jobs runner start

archdev jobs runner stop

Stop the local daemon without uninstalling it

archdev jobs runner stop

archdev jobs runner doctor

Diagnose the native daemon service and optionally repair it

archdev jobs runner doctor [options]
Flag Description Default
--repair Repair a verified ArchDev service registration and wait for readiness

archdev jobs runner uninstall

Remove the daemon; preserve data unless --purge is specified

archdev jobs runner uninstall [options]
Flag Description Default
--purge Permanently delete private repositories and SQLite data after cleaning owned jobs

archdev jobs runner status

archdev jobs runner status

archdev jobs repo

Enable, submit, sync, or disable repository automation

archdev jobs repo

archdev jobs repo enable

Initialize this repository for ArchDev local automation

archdev jobs repo enable [options]
Flag Description Default
--name <name> Use a unique private repository name

archdev jobs repo disable

Detach this repository from ArchDev local automation

archdev jobs repo disable [options]
Flag Description Default
--delete-repo Clean owned worktrees and delete the private repo; refuse active jobs or retained worktrees

archdev jobs repo submit

Push the current branch to the private ArchDev repository

archdev jobs repo submit [options]
Flag Description Default
--task <task-id> Task this push delivers work for; repeat for several
--task-title <title> Durable human title for the originating Task; Factory submission only
--factory-submit Internal Factory submission; skip checkout rebase and require --task
--factory-receipt <receipt-id> Internal Factory durable submission receipt
--factory-no-task-link Internal Factory submission without PR Task linking
--force Override an active lease another session holds for a pushed Task
--keep-previous-pr Keep a Task's previous pull request open when this push supersedes its ref
--lease <lease-id/session-id> Internal Factory durable Task-session lease this push adopts

archdev jobs repo sync

Fast-forward this checkout to its latest successful pipeline result

archdev jobs repo sync

archdev rooms

Create and participate in ArchDev rooms

Aliases: room

archdev rooms

archdev rooms connect

Connect to an organization room or a joined or joinable team room

archdev rooms connect [room]
Argument Description
[room] Room name or ID; omit to pick interactively

Search indexed Room knowledge

archdev rooms search <query> [options]
Argument Description
<query> Search text matched against indexed Room knowledge
Flag Description Default
--room <name-or-id> Search a specific Room
--messages Search Room messages instead of indexed knowledge
--limit <count> Results to return 10

archdev rooms list

List the organization room and joined or joinable team rooms

archdev rooms list

archdev rooms show

Show one room

archdev rooms show <room-id>
Argument Description
<room-id> ID of the room to show

archdev rooms create

Create an ArchDev room for your organization

archdev rooms create <name> [options]
Argument Description
<name> Name for the new room
Flag Description Default
-d, --description <text> Describe the room

archdev rooms join

Join a room visible to your organization

archdev rooms join <room-id>
Argument Description
<room-id> ID of the room to join

archdev rooms messages

Read recent room messages

archdev rooms messages <room-id> [options]
Argument Description
<room-id> ID of the room whose messages to read
Flag Description Default
--limit <count> Messages to return 50

archdev rooms post

Post to a room

archdev rooms post <room-id> <message> [options]
Argument Description
<room-id> ID of the room to post to
<message> Message text to post
Flag Description Default
--attachment <path> Attach a screenshot or file (repeatable) []

archdev rooms start

Announce substantial work whose scope is understood

archdev rooms start <headline> [options]
Argument Description
<headline> One-line headline for the lifecycle post
Flag Description Default
-b, --bullet <fact> Add one factual detail (repeatable) []
-r, --ref <reference> Add a commit, PR, issue, or path reference (repeatable) []
-a, --attach <path> Attach a screenshot or file (repeatable) []
--answers <message-id> Link this post to a question message
--no-meta Omit best-effort Git and session enrichment
--risk <level> Originating-agent consequence hint (low|medium|high). Self-asserted, not a scored verdict. Search the room first; do not copy prior hints.
--complexity <level> Originating-agent complexity hint (low|medium|high). Self-asserted.
--basis <source> What the hint is based on (room_history|diff|none) "none"
--dry-run Print the exact post without enqueueing it
--room <name-or-id> Post to a specific Room

archdev rooms done

Publish a meaningful completed outcome

archdev rooms done <headline> [options]
Argument Description
<headline> One-line headline for the lifecycle post
Flag Description Default
-b, --bullet <fact> Add one factual detail (repeatable) []
-r, --ref <reference> Add a commit, PR, issue, or path reference (repeatable) []
-a, --attach <path> Attach a screenshot or file (repeatable) []
--answers <message-id> Link this post to a question message
--no-meta Omit best-effort Git and session enrichment
--risk <level> Originating-agent consequence hint (low|medium|high). Self-asserted, not a scored verdict. Search the room first; do not copy prior hints.
--complexity <level> Originating-agent complexity hint (low|medium|high). Self-asserted.
--basis <source> What the hint is based on (room_history|diff|none) "none"
--dry-run Print the exact post without enqueueing it
--room <name-or-id> Post to a specific Room

archdev rooms lesson

Publish a reusable root cause, failure, or fix

archdev rooms lesson <headline> [options]
Argument Description
<headline> One-line headline for the lifecycle post
Flag Description Default
-b, --bullet <fact> Add one factual detail (repeatable) []
-r, --ref <reference> Add a commit, PR, issue, or path reference (repeatable) []
-a, --attach <path> Attach a screenshot or file (repeatable) []
--answers <message-id> Link this post to a question message
--no-meta Omit best-effort Git and session enrichment
--risk <level> Originating-agent consequence hint (low|medium|high). Self-asserted, not a scored verdict. Search the room first; do not copy prior hints.
--complexity <level> Originating-agent complexity hint (low|medium|high). Self-asserted.
--basis <source> What the hint is based on (room_history|diff|none) "none"
--dry-run Print the exact post without enqueueing it
--room <name-or-id> Post to a specific Room

archdev rooms abandoned

Record a failed approach teammates should avoid

archdev rooms abandoned <headline> [options]
Argument Description
<headline> One-line headline for the lifecycle post
Flag Description Default
-b, --bullet <fact> Add one factual detail (repeatable) []
-r, --ref <reference> Add a commit, PR, issue, or path reference (repeatable) []
-a, --attach <path> Attach a screenshot or file (repeatable) []
--answers <message-id> Link this post to a question message
--no-meta Omit best-effort Git and session enrichment
--risk <level> Originating-agent consequence hint (low|medium|high). Self-asserted, not a scored verdict. Search the room first; do not copy prior hints.
--complexity <level> Originating-agent complexity hint (low|medium|high). Self-asserted.
--basis <source> What the hint is based on (room_history|diff|none) "none"
--dry-run Print the exact post without enqueueing it
--room <name-or-id> Post to a specific Room

archdev rooms handoff

Hand work to a named teammate

archdev rooms handoff <headline> [options]
Argument Description
<headline> One-line headline for the lifecycle post
Flag Description Default
-b, --bullet <fact> Add one factual detail (repeatable) []
-r, --ref <reference> Add a commit, PR, issue, or path reference (repeatable) []
-a, --attach <path> Attach a screenshot or file (repeatable) []
--answers <message-id> Link this post to a question message
--no-meta Omit best-effort Git and session enrichment
--risk <level> Originating-agent consequence hint (low|medium|high). Self-asserted, not a scored verdict. Search the room first; do not copy prior hints.
--complexity <level> Originating-agent complexity hint (low|medium|high). Self-asserted.
--basis <source> What the hint is based on (room_history|diff|none) "none"
--dry-run Print the exact post without enqueueing it
--room <name-or-id> Post to a specific Room

archdev rooms question

Ask a named teammate an unresolved question

archdev rooms question <headline> [options]
Argument Description
<headline> One-line headline for the lifecycle post
Flag Description Default
-b, --bullet <fact> Add one factual detail (repeatable) []
-r, --ref <reference> Add a commit, PR, issue, or path reference (repeatable) []
-a, --attach <path> Attach a screenshot or file (repeatable) []
--answers <message-id> Link this post to a question message
--no-meta Omit best-effort Git and session enrichment
--risk <level> Originating-agent consequence hint (low|medium|high). Self-asserted, not a scored verdict. Search the room first; do not copy prior hints.
--complexity <level> Originating-agent complexity hint (low|medium|high). Self-asserted.
--basis <source> What the hint is based on (room_history|diff|none) "none"
--dry-run Print the exact post without enqueueing it
--room <name-or-id> Post to a specific Room

archdev rooms jobs

Deprecated. The CLI prints the replacement at runtime. Deprecated aliases for room-scoped tasks commands

archdev rooms jobs

archdev rooms jobs list

Deprecated. The CLI prints the replacement at runtime. List jobs filed in a room

archdev rooms jobs list <room-id> [options]
Argument Description
<room-id> ID of the room whose jobs to list
Flag Description Default
--limit <count> Jobs to return 100
--status <status> Task status

archdev rooms jobs create

Deprecated. The CLI prints the replacement at runtime. File a room job as an up-for-grabs task

archdev rooms jobs create <room-id> <job> [options]
Argument Description
<room-id> ID of the room to file the job in
<job> Job title to file as an up-for-grabs task
Flag Description Default
--kind <kind> One-off or recurring cadence "once"
--priority <priority> Priority from 0 (highest) to 4 2

archdev rooms jobs complete

Deprecated. The CLI prints the replacement at runtime. Mark a room-owned job done

archdev rooms jobs complete <room-id> <job-id>
Argument Description
<room-id> ID of the room owning the job
<job-id> ID of the job to mark done

archdev rooms status

Read the room's held status shelf

archdev rooms status

archdev rooms status list

List flagged and non-job pinned status cards

archdev rooms status list <room-id> [options]
Argument Description
<room-id> ID of the room whose status cards to list
Flag Description Default
--limit <count> Cards to inspect 100

archdev rooms records

Read and manage approved room knowledge

archdev rooms records

archdev rooms records list

List room records

archdev rooms records list <room-id> [options]
Argument Description
<room-id> ID of the room whose records to list
Flag Description Default
--status <status> Filter by record status
--kind <kind> Filter by record kind
--query <text> Search configured record fields

archdev rooms records show

Show a room record

archdev rooms records show <room-id> <record-id>
Argument Description
<room-id> ID of the room holding the record
<record-id> ID of the record to show

archdev rooms records status

Set a room record lifecycle status with explicit human approval

archdev rooms records status <room-id> <record-id> <status> [options]
Argument Description
<room-id> ID of the room holding the record
<record-id> ID of the record to update
<status> New record status
Flag Description Default
--approver <name> Human approver (required for approved or rejected)

archdev rooms insights

Summarize room charts and records

archdev rooms insights

archdev rooms insights summary

Summarize rich messages, charts, and room records

archdev rooms insights summary <room-id> [options]
Argument Description
<room-id> ID of the room to summarize
Flag Description Default
--limit <count> Recent messages to inspect 100

archdev log

Write a message to your organization's room (free text or a schema-validated activity event)

archdev log [message...] [options]
Argument Description
[message...] What to say
Flag Description Default
--event <type> Activity event (default: agent.message)
--payload-file <path> Stored extraction envelope value for a structured event
--assessment <path> Sealed risk assessment JSON (required for plan/task/pr events)
--message <text> Headline for a structured event (the post always includes a readable summary of the payload)
--idempotency-key <key> Dedup key for retries (default: fresh random key per call)

archdev push

Deprecated. The CLI prints the replacement at runtime. Push the current branch to the private ArchDev repository

archdev push [options]
Flag Description Default
--task <task-id> Task this push delivers work for; repeat for several
--task-title <title> Durable human title for the originating Task; Factory submission only
--factory-submit Internal Factory submission; skip checkout rebase and require --task
--factory-receipt <receipt-id> Internal Factory durable submission receipt
--factory-no-task-link Internal Factory submission without PR Task linking
--force Override an active lease another session holds for a pushed Task
--keep-previous-pr Keep a Task's previous pull request open when this push supersedes its ref
--lease <lease-id/session-id> Internal Factory durable Task-session lease this push adopts

archdev inspect

Deprecated. The CLI prints the replacement at runtime. Inspect local changes, open pull requests, run workflows and publish

Aliases: reviews

archdev inspect [options]
Flag Description Default
--no-open Print the review inbox URL without opening a browser

archdev inspect inbox

Deprecated. The CLI prints the replacement at runtime. Open the Needs review inbox in ArchCode

archdev inspect inbox [options]
Flag Description Default
--no-open Print the URL without opening a browser

archdev inspect open

Deprecated. The CLI prints the replacement at runtime. Open a pull request in ArchCode

archdev inspect open <pull-request> [options]
Argument Description
<pull-request> Pull request URL, owner/repo#123, or number
Flag Description Default
--no-open Print the URL without opening a browser

archdev inspect checkout

Deprecated. The CLI prints the replacement at runtime. Open a shell in a PR's local worktree, creating one when needed

archdev inspect checkout <pull-request> [options]
Argument Description
<pull-request> PR number, owner/repo#123, or GitHub/ArchCode URL
Flag Description Default
--path Print only the worktree path for cd/command substitution

archdev inspect local

Deprecated. The CLI prints the replacement at runtime. Review an immutable snapshot of local changes in ArchCode

archdev inspect local [options]
Flag Description Default
--base <ref> Local base ref "origin/main"
--model <model> Model ID or @alias for metadata; openai/... or xai/... needs no ArchDev login
--no-open Print the local review URL without opening a browser
--metadata <path> Serve agent-authored review metadata (archdev.review-metadata.v1); use - for stdin
--no-metadata Serve the snapshot without any risk/theme analysis
--feedback-format <format> Feedback output for humans or streaming agents "markdown"

archdev inspect manifest

Deprecated. The CLI prints the replacement at runtime. Print the frozen local change set for authoring review metadata

archdev inspect manifest [options]
Flag Description Default
--base <ref> Local base ref "origin/main"

archdev inspect guide

Deprecated. The CLI prints the replacement at runtime. Print instructions for agents authoring review metadata

archdev inspect guide

archdev inspect metadata

Deprecated. The CLI prints the replacement at runtime. Print the review annotations published for a pull request

archdev inspect metadata <pull> [options]
Argument Description
<pull> Pull request: a number, owner/repo#123, or a pull request URL
Flag Description Default
--sha <head-sha> Read the revision published for this head commit (default: the newest)
--list List the published revisions instead of one document

archdev inspect setup

Deprecated. The CLI prints the replacement at runtime. Install archdev hooks into the coding harnesses on this machine

archdev inspect setup [options]
Flag Description Default
--harness <name...> Harnesses to configure (default: every one installed)
--force Replace archdev hooks that are already installed
--uninstall Remove archdev hooks instead of installing them

archdev inspect hook

Deprecated. The CLI prints the replacement at runtime. Handle a harness lifecycle hook

archdev inspect hook <name> [options]
Argument Description
<name> Hook name, e.g. stop
Flag Description Default
--harness <name> Harness that fired the hook
--session <id> Harness session id (default: from the payload)
--payload <json> Event payload: inline JSON, @file, or - for stdin (default: stdin)

archdev inspect workflows

Deprecated. The CLI prints the replacement at runtime. List, inspect and run named AI review workflows

archdev inspect workflows

archdev inspect workflows list

Deprecated. The CLI prints the replacement at runtime. List effective project, user and built-in review workflows

archdev inspect workflows list

archdev inspect workflows show

Deprecated. The CLI prints the replacement at runtime. Show the effective workflow definition and its source

archdev inspect workflows show <name>
Argument Description
<name> Name of the workflow to show

archdev inspect workflows run

Deprecated. The CLI prints the replacement at runtime. Run a review workflow against an explicit diff target

archdev inspect workflows run [workflow] [options]
Argument Description
[workflow] Review workflow (default: review.default_workflow, then the built-in default)
Flag Description Default
--output-format <format> With --print, --review, or --workflow, the output format: text or json "text"
--target <target> Diff to review

archdev inspect publish

Deprecated. The CLI prints the replacement at runtime. Publish the reviewed branch and sparse source annotations

archdev inspect publish [options]
Flag Description Default
--base <branch> GitHub base branch "main"
--remote <remote> GitHub Git remote "origin"
--model <model> Platform model ID or @alias used to label the frozen diffs
--context <path> Optional pipeline output supplied to the model; use - for stdin
--metadata <path> Use pre-generated PR info and sparse annotations; use - for stdin
--review-bundle-fallback Publish without review annotations if generation remains invalid
--force-with-lease <head-sha> Replace the PR branch only if GitHub is still at this exact head
--expected-base-ancestor <base-sha> Refuse publication unless the fetched base still contains this frozen commit
--pull <number> Update this existing pull request instead of inferring one from the current branch
--task <task-id> Link the published PR to this task; defaults to the task named by a Factory branch, none to skip
--task-title <title> Durable human title snapshotted at Factory submission

archdev inspect generate

Deprecated. The CLI prints the replacement at runtime. Generate validated publication JSON without publishing

archdev inspect generate

archdev inspect generate pull-request

Deprecated. The CLI prints the replacement at runtime. Generate PR title, body, and draft state as JSON

archdev inspect generate pull-request [options]
Flag Description Default
--base <branch> GitHub base branch "main"
--remote <remote> GitHub Git remote "origin"
--model <model> Model ID or @alias
--context <path> Optional pipeline output supplied to the model; use - for stdin
--fallback Use the configured deterministic fallback when generation fails

archdev inspect generate metadata

Deprecated. The CLI prints the replacement at runtime. Generate semantic hunk review metadata as JSON

archdev inspect generate metadata [options]
Flag Description Default
--pull <number> Use this PR instead of inferring one from the current branch
--base <branch> GitHub base branch "main"
--remote <remote> GitHub Git remote "origin"
--model <model> Model ID or @alias
--context <path> Optional pipeline output supplied to the model; use - for stdin
--fallback Use the configured deterministic fallback when generation fails

archdev publish

Deprecated. The CLI prints the replacement at runtime. Publish the reviewed branch and sparse source annotations

archdev publish [options]
Flag Description Default
--base <branch> GitHub base branch "main"
--remote <remote> GitHub Git remote "origin"
--model <model> Platform model ID or @alias used to label the frozen diffs
--context <path> Optional pipeline output supplied to the model; use - for stdin
--metadata <path> Use pre-generated PR info and sparse annotations; use - for stdin
--review-bundle-fallback Publish without review annotations if generation remains invalid
--force-with-lease <head-sha> Replace the PR branch only if GitHub is still at this exact head
--expected-base-ancestor <base-sha> Refuse publication unless the fetched base still contains this frozen commit
--pull <number> Update this existing pull request instead of inferring one from the current branch
--task <task-id> Link the published PR to this task; defaults to the task named by a Factory branch, none to skip
--task-title <title> Durable human title snapshotted at Factory submission

archdev publish generate

Deprecated. The CLI prints the replacement at runtime. Generate validated publication JSON without publishing

archdev publish generate

archdev publish generate pull-request

Deprecated. The CLI prints the replacement at runtime. Generate PR title, body, and draft state as JSON

archdev publish generate pull-request [options]
Flag Description Default
--base <branch> GitHub base branch "main"
--remote <remote> GitHub Git remote "origin"
--model <model> Model ID or @alias
--context <path> Optional pipeline output supplied to the model; use - for stdin
--fallback Use the configured deterministic fallback when generation fails

archdev publish generate review-metadata

Deprecated. The CLI prints the replacement at runtime. Generate semantic hunk review metadata as JSON

archdev publish generate review-metadata [options]
Flag Description Default
--pull <number> Use this PR instead of inferring one from the current branch
--base <branch> GitHub base branch "main"
--remote <remote> GitHub Git remote "origin"
--model <model> Model ID or @alias
--context <path> Optional pipeline output supplied to the model; use - for stdin
--fallback Use the configured deterministic fallback when generation fails

archdev review

Deprecated. The CLI prints the replacement at runtime. Review an immutable snapshot of local changes in ArchCode

archdev review [options]
Flag Description Default
--base <ref> Local base ref "origin/main"
--model <model> Model ID or @alias for metadata; openai/... or xai/... needs no ArchDev login
--no-open Print the local review URL without opening a browser
--metadata <path> Serve agent-authored review metadata (archdev.review-metadata.v1); use - for stdin
--no-metadata Serve the snapshot without any risk/theme analysis
--feedback-format <format> Feedback output for humans or streaming agents "markdown"

archdev sync

Deprecated. The CLI prints the replacement at runtime. Fast-forward this checkout to its latest successful pipeline result

archdev sync

archdev wt

Deprecated. The CLI prints the replacement at runtime. Create and remove Git worktrees with repository lifecycle hooks

archdev wt

archdev wt create

Deprecated. The CLI prints the replacement at runtime. Create a worktree and run worktree.hooks.after_worktree_create

archdev wt create <branch> [path] [options]
Argument Description
<branch> Branch to check out or create
[path] Worktree path
Flag Description Default
--start-point <ref> Starting ref for a new branch "HEAD"

archdev wt remove

Deprecated. The CLI prints the replacement at runtime. Remove a worktree and run worktree.hooks.after_worktree_delete

archdev wt remove <path> [options]
Argument Description
<path> Worktree path
Flag Description Default
--force Remove a dirty worktree or leftover files

archdev check

Validate ArchDev configuration without executing it

archdev check

archdev repo

Repository readiness, activity mapping, monitoring, and hooks

archdev repo

archdev repo status

Probe CLI, login, model access, repo wiring, taxonomy, and hooks

archdev repo status [options]
Flag Description Default
--json Output machine-readable checks

archdev repo init

Initialize this repository for ArchDev local automation

archdev repo init [options]
Flag Description Default
--name <name> Use a unique private repository name

archdev repo map

Scaffold and document the repo activity taxonomy

archdev repo map

archdev repo map init

Scaffold the activity skeleton in archdev.json

archdev repo map init [options]
Flag Description Default
--force Replace an already-filled taxonomy

archdev repo map bootstrap

Print the mapping interview guide (Markdown)

archdev repo map bootstrap

archdev repo monitor

Print the monitor self-check block (Markdown)

archdev repo monitor

archdev repo monitor bootstrap

Print the self-check block for the activity config

archdev repo monitor bootstrap

archdev repo hook

Harness start/stop hooks for activity monitoring

archdev repo hook

archdev repo hook setup

Install archdev hooks into the coding harnesses on this machine

Aliases: install

archdev repo hook setup [options]
Flag Description Default
--harness <name...> Harnesses to configure (default: every one installed)
--force Replace archdev hooks that are already installed
--uninstall Remove archdev hooks instead of installing them

archdev repo hook start

Handle a harness session start (emits session_started)

archdev repo hook start [options]
Flag Description Default
--harness <name> Harness that fired the hook
--session <id> Harness session id (default: from the payload)
--payload <json> Event payload: inline JSON, @file, or - for stdin (default: stdin)

archdev repo hook stop

Handle a harness stopping point (Phase 1: reminder only)

archdev repo hook stop [options]
Flag Description Default
--harness <name> Harness that fired the hook
--payload <json> Event payload: inline JSON, @file, or - for stdin (default: stdin)

archdev pipeline

Deprecated. The CLI prints the replacement at runtime. Run named ArchDev pipelines

archdev pipeline

archdev pipeline run

Deprecated. The CLI prints the replacement at runtime. Run a named pipeline in the current Git worktree

archdev pipeline run <name>
Argument Description
<name> Name of the pipeline to run

archdev factory

Deprecated. The CLI prints the replacement at runtime. Run the ArchDev Factory; maintain local work with agents work

archdev factory

archdev factory run

Deprecated. The CLI prints the replacement at runtime. Start ArchDev as a software factory

archdev factory run [options]
Flag Description Default
--factory Run the interactive TUI as a software factory true
--workers <n> Factory worker subprocesses (1-32) 3
--dispatch <mode> Factory task dispatch: auto claims every ready task; manual claims only tasks you release
--autonomy <mode> Factory overseer autonomy: confirm (default) or auto for evidence-backed unblocking
--resume <session> Resume a saved ArchDev session id
-p, --print <prompt> Run one prompt non-interactively and print the result, then exit
--review <workflow> Run a review workflow from .archdev/reviews non-interactively
--workflow <workflow> Run a workflow from .archdev/workflows non-interactively
--workflow-input <text> Invocation input exposed to workflow prompts as {{input}}
--review-target <target> Diff to review: current-files or branch-commits
--output-format <format> With --print, --review, or --workflow, the output format: text or json "text"
--model <id> Model id to run with
--max-turns <n> With --print, the maximum agent turns before stopping
--permission-mode <mode> With --print, set the headless agent permission mode
--stream With --print, stream transcript events as NDJSON on stdout and read steering messages from stdin (implies JSON output)
--image <prompt> Generate an image non-interactively from the supplied prompt
--image-model <id> Image model id; omit for the platform default
--image-list-models List the available image models and exit
--image-options List every image generation option and exit
--image-output-format <format> Shape of image stdout: text or json
--image-output-dir <dir> Directory to write the generated images into (created if missing) "."
--image-count <n> Number of images to generate, one request each (max 10) 1
--image-filename <name> Base filename to write (extension added when absent); defaults to a slug of the prompt
--image-overwrite Replace an existing file instead of picking the next free name false
--image-input <path> Source image to edit (repeatable). Sends the file to the image-edits API instead of generating from scratch
--image-aspect-ratio <ratio> Aspect ratio, e.g. "1:1" or "16:9"
--image-dimensions <WxH> Output dimensions, e.g. "1024x1024"
--image-size <tier> Resolution tier, e.g. "1K", "2K", "4K"
--image-width <px> Output width in pixels
--image-height <px> Output height in pixels
--image-quality <quality> Quality preset (model-dependent)
--image-style <style> Style preset (model-dependent)
--image-background <background> Background treatment (model-dependent)
--image-format <format> Image file format to request: png, jpeg, or webp

archdev factory status

Deprecated. The CLI prints the replacement at runtime. Show this repository's Factory holder

archdev factory status

archdev factory stop

Deprecated. The CLI prints the replacement at runtime. Stop this repository's Factory overseer

archdev factory stop [options]
Flag Description Default
--force Escalate to SIGKILL after the timeout false
--timeout <s> Seconds to wait for graceful shutdown 30

archdev factory circuits

Deprecated. The CLI prints the replacement at runtime. Show which model candidates each Factory worker is skipping, and when each is probed next

archdev factory circuits [options]
Flag Description Default
--timeout <s> Seconds to wait for every worker to answer 5

archdev factory reset-circuits

Deprecated. The CLI prints the replacement at runtime. Clear model candidate circuits in every Factory worker without restarting the Factory

archdev factory reset-circuits [options]
Flag Description Default
--timeout <s> Seconds to wait for every worker to answer 5

archdev agents

Start, run, resume and manage coding agents

archdev agents

archdev agents start

Start an interactive coding session, optionally with a prompt

archdev agents start [prompt] [options]
Argument Description
[prompt] Initial prompt for the session
Flag Description Default
--model <id> Model id to run with

archdev agents run

Run one headless request or generate an image

archdev agents run [prompt] [options]
Argument Description
[prompt] Initial prompt for the session
Flag Description Default
--resume <session> Resume a saved ArchDev session id
--output-format <format> With --print, --review, or --workflow, the output format: text or json "text"
--model <id> Model id to run with
--max-turns <n> With --print, the maximum agent turns before stopping
--permission-mode <mode> With --print, set the headless agent permission mode
--stream With --print, stream transcript events as NDJSON on stdout and read steering messages from stdin (implies JSON output)
--image <prompt> Generate an image non-interactively from the supplied prompt
--image-model <id> Image model id; omit for the platform default
--image-list-models List the available image models and exit
--image-options List every image generation option and exit
--image-output-format <format> Shape of image stdout: text or json
--image-output-dir <dir> Directory to write the generated images into (created if missing) "."
--image-count <n> Number of images to generate, one request each (max 10) 1
--image-filename <name> Base filename to write (extension added when absent); defaults to a slug of the prompt
--image-overwrite Replace an existing file instead of picking the next free name false
--image-input <path> Source image to edit (repeatable). Sends the file to the image-edits API instead of generating from scratch
--image-aspect-ratio <ratio> Aspect ratio, e.g. "1:1" or "16:9"
--image-dimensions <WxH> Output dimensions, e.g. "1024x1024"
--image-size <tier> Resolution tier, e.g. "1K", "2K", "4K"
--image-width <px> Output width in pixels
--image-height <px> Output height in pixels
--image-quality <quality> Quality preset (model-dependent)
--image-style <style> Style preset (model-dependent)
--image-background <background> Background treatment (model-dependent)
--image-format <format> Image file format to request: png, jpeg, or webp

archdev agents resume

Resume a saved ordinary or Factory session

archdev agents resume <session-id> [options]
Argument Description
<session-id> ID of the saved session to resume
Flag Description Default
--model <id> Model id to run with

archdev agents evaluate

Ask typed boolean, choice, and score questions about stdin with Jev

archdev agents evaluate [options]
Flag Description Default
--boolean <id=question> P(true) question (repeatable) []
--choice <id=question> Categorical question (repeatable) []
--choices <id=a,b,...> Choices for the named question (repeatable) []
--score <id=question> Ordered-score question (repeatable) []
--levels <id=low,...,high> Score levels for the named question (repeatable) []
--questions <path> JSON file of named typed questions
-m, --model <id> Evaluation model id; omit for the platform default. -m jev is jev-latest.
--input <format> State format: auto, text, or json "auto"
--list-models List the available evaluation models and exit

archdev agents workflows

Execute model-driven workflows

archdev agents workflows

archdev agents workflows run

Run a declarative model-driven workflow

archdev agents workflows run <name> [options]
Argument Description
<name> Name of the declarative workflow to run
Flag Description Default
--output-format <format> With --print, --review, or --workflow, the output format: text or json "text"
--input <text> Invocation input exposed to workflow prompts as {{input}}

archdev agents factory

Run the ArchDev Factory; maintain local work with agents work

archdev agents factory

archdev agents factory run

Start ArchDev as a software factory

archdev agents factory run [options]
Flag Description Default
--factory Run the interactive TUI as a software factory true
--workers <n> Factory worker subprocesses (1-32) 3
--dispatch <mode> Factory task dispatch: auto claims every ready task; manual claims only tasks you release
--autonomy <mode> Factory overseer autonomy: confirm (default) or auto for evidence-backed unblocking
--resume <session> Resume a saved ArchDev session id
-p, --print <prompt> Run one prompt non-interactively and print the result, then exit
--review <workflow> Run a review workflow from .archdev/reviews non-interactively
--workflow <workflow> Run a workflow from .archdev/workflows non-interactively
--workflow-input <text> Invocation input exposed to workflow prompts as {{input}}
--review-target <target> Diff to review: current-files or branch-commits
--output-format <format> With --print, --review, or --workflow, the output format: text or json "text"
--model <id> Model id to run with
--max-turns <n> With --print, the maximum agent turns before stopping
--permission-mode <mode> With --print, set the headless agent permission mode
--stream With --print, stream transcript events as NDJSON on stdout and read steering messages from stdin (implies JSON output)
--image <prompt> Generate an image non-interactively from the supplied prompt
--image-model <id> Image model id; omit for the platform default
--image-list-models List the available image models and exit
--image-options List every image generation option and exit
--image-output-format <format> Shape of image stdout: text or json
--image-output-dir <dir> Directory to write the generated images into (created if missing) "."
--image-count <n> Number of images to generate, one request each (max 10) 1
--image-filename <name> Base filename to write (extension added when absent); defaults to a slug of the prompt
--image-overwrite Replace an existing file instead of picking the next free name false
--image-input <path> Source image to edit (repeatable). Sends the file to the image-edits API instead of generating from scratch
--image-aspect-ratio <ratio> Aspect ratio, e.g. "1:1" or "16:9"
--image-dimensions <WxH> Output dimensions, e.g. "1024x1024"
--image-size <tier> Resolution tier, e.g. "1K", "2K", "4K"
--image-width <px> Output width in pixels
--image-height <px> Output height in pixels
--image-quality <quality> Quality preset (model-dependent)
--image-style <style> Style preset (model-dependent)
--image-background <background> Background treatment (model-dependent)
--image-format <format> Image file format to request: png, jpeg, or webp

archdev agents factory status

Show this repository's Factory holder

archdev agents factory status

archdev agents factory stop

Stop this repository's Factory overseer

archdev agents factory stop [options]
Flag Description Default
--force Escalate to SIGKILL after the timeout false
--timeout <s> Seconds to wait for graceful shutdown 30

archdev agents factory circuits

Show which model candidates each Factory worker is skipping, and when each is probed next

archdev agents factory circuits [options]
Flag Description Default
--timeout <s> Seconds to wait for every worker to answer 5

archdev agents factory reset-circuits

Clear model candidate circuits in every Factory worker without restarting the Factory

archdev agents factory reset-circuits [options]
Flag Description Default
--timeout <s> Seconds to wait for every worker to answer 5

archdev agents worktrees

Create and remove Git worktrees with repository lifecycle hooks

archdev agents worktrees

archdev agents worktrees create

Create a worktree and run worktree.hooks.after_worktree_create

archdev agents worktrees create <branch> [path] [options]
Argument Description
<branch> Branch to check out or create
[path] Worktree path
Flag Description Default
--start-point <ref> Starting ref for a new branch "HEAD"

archdev agents worktrees remove

Remove a worktree and run worktree.hooks.after_worktree_delete

archdev agents worktrees remove <path> [options]
Argument Description
<path> Worktree path
Flag Description Default
--force Remove a dirty worktree or leftover files

archdev agents definitions

Inspect effective local agent definitions (project overrides user)

archdev agents definitions

archdev agents definitions list

List effective definitions and source files

archdev agents definitions list

archdev agents definitions show

Show a resolved definition and effective tools

archdev agents definitions show <name>
Argument Description
<name> Name of the agent definition to show

archdev agents sessions

Inspect and stop this project's top-level agent sessions

archdev agents sessions

archdev agents sessions list

List running and resumable sessions for this project

archdev agents sessions list

archdev agents sessions show

Show session identity, model, child work, and resume state

archdev agents sessions show <id>
Argument Description
<id> ID of the session to show

archdev agents sessions stop

Ask the running session owner to cancel and drain its work

archdev agents sessions stop <id>
Argument Description
<id> ID of the running session to stop

archdev agents setup

Connect model access and validate agent settings without installing Jobs

archdev agents setup [options]
Flag Description Default
--provider <provider> Choose archdev, openai, or xai without the interactive wizard
--provider-email <email> Provider account email for non-interactive OpenAI or xAI setup
--device-code Log in to OpenAI or xAI with device-code OAuth (SSH / remote browser)

archdev agents work

Local work bindings, sessions, and owned workspaces

archdev agents work

archdev agents work list

List this project's durable local work

archdev agents work list

archdev agents work show

Show one local work binding by its stable ID

archdev agents work show <id>
Argument Description
<id> Stable ID of the local work binding to show

archdev agents work discard

Permanently discard one invalid work record or orphan worktree by ID, without touching other project work

archdev agents work discard <id>
Argument Description
<id> Stable ID of the invalid work record or orphan worktree to discard

archdev agents work clean

Clean terminal local work and obsolete bookkeeping. Unpublished work of a done or cancelled Task is saved under the reports directory before its checkout is removed; active work is retained

archdev agents work clean [ids...]
Argument Description
[ids...] Work IDs to clean; omit to clean all terminal work

archdev agents work reset

Permanently discard this project's managed work, including unpublished changes

archdev agents work reset [options]
Flag Description Default
--yes Confirm permanent loss of this project's local work

archdev init

Deprecated. The CLI prints the replacement at runtime. Initialize this repository for ArchDev local automation

archdev init [options]
Flag Description Default
--name <name> Use a unique private repository name

archdev deinit

Deprecated. The CLI prints the replacement at runtime. Detach this repository from ArchDev local automation

archdev deinit [options]
Flag Description Default
--delete-repo Clean owned worktrees and delete the private repo; refuse active jobs or retained worktrees

archdev daemon

Deprecated. The CLI prints the replacement at runtime. Manage the shared ArchDev local automation daemon

archdev daemon

archdev daemon install

Deprecated. The CLI prints the replacement at runtime. Install the local daemon without prompting; the only silent first-install command

archdev daemon install [options]
Flag Description Default
--existing-only Refresh and restart an existing managed daemon without creating one

archdev daemon start

Deprecated. The CLI prints the replacement at runtime. Start the installed local daemon

archdev daemon start

archdev daemon stop

Deprecated. The CLI prints the replacement at runtime. Stop the local daemon without uninstalling it

archdev daemon stop

archdev daemon doctor

Deprecated. The CLI prints the replacement at runtime. Diagnose the native daemon service and optionally repair it

archdev daemon doctor [options]
Flag Description Default
--repair Repair a verified ArchDev service registration and wait for readiness

archdev daemon uninstall

Deprecated. The CLI prints the replacement at runtime. Remove the daemon; preserve data unless --purge is specified

archdev daemon uninstall [options]
Flag Description Default
--purge Permanently delete private repositories and SQLite data after cleaning owned jobs

archdev daemon status

Deprecated. The CLI prints the replacement at runtime.

archdev daemon status

archdev daemon jobs

Deprecated. The CLI prints the replacement at runtime. List, create, cancel, clean, or restart local automation jobs

archdev daemon jobs

archdev daemon jobs create

Deprecated. The CLI prints the replacement at runtime. Create a daemon job for the current private branch

archdev daemon jobs create <type> [options]
Argument Description
<type> Job type: branch_update, branch_rebase_conflict, or one_off
Flag Description Default
--payload <json> JSON payload passed to the job

archdev daemon jobs cancel

Deprecated. The CLI prints the replacement at runtime. Cancel a queued or running daemon job

archdev daemon jobs cancel <id>
Argument Description
<id> ID of the job to cancel

archdev daemon jobs clean

Deprecated. The CLI prints the replacement at runtime. Remove terminal jobs, or all matching jobs with --all

archdev daemon jobs clean [options]
Flag Description Default
--status <status...> Only clean these states (queued and running require --all)
--after <timestamp> Only clean jobs updated at or after this time
--before <timestamp> Only clean jobs updated at or before this time
--force Remove clean nested worktrees missing lifecycle ownership, and prune archastro/wt-* branches on the mirror with no registered worktree
--keep-rows Remove job artifacts but keep the job rows (history and reports stay queryable)
--all Stop the daemon and permanently delete matching jobs, including active jobs
--yes Confirm --all cleanup without prompting

archdev daemon jobs restart

Deprecated. The CLI prints the replacement at runtime. Retry a failed job using its snapshot or rebased branch; PR retries belong to the watcher

archdev daemon jobs restart <id>
Argument Description
<id> ID of the failed job to retry

archdev daemon job

Deprecated. The CLI prints the replacement at runtime. Inspect a local automation job

archdev daemon job

archdev daemon job show

Deprecated. The CLI prints the replacement at runtime. Inspect job input, attempts, steps, outputs, and result

archdev daemon job show <id>
Argument Description
<id> ID of the job to inspect