{ "$id": "https://discern.sh/schema/v1/discern-cli.json", "format": 1, "x-discern-compatibility-policy": "cli-append-only", "implicit_flags": { "command": [ "-h", "--help" ], "root": [ "-V", "--version" ] }, "commands": [ { "path": [], "description": "Operate your project's quality gate (its full quality check) and Git worktrees (a separate checkout and branch for each effort); `discern setup` explains the first step and `discern setup begin` scaffolds the stack-neutral system.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": " [options]", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "setup" ], "description": "Read the setup welcome and learn the canonical first step. Run `discern setup begin` only after the owner is ready to scaffold.", "aliases": [], "hidden": false, "hidden_when": "bootstrapped", "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "setup", "verify" ], "description": "Preview what setup will do and the consent checklist to confirm with your human (read-only).", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "setup", "begin" ], "description": "Scaffold discern, record provenance, and print the setup brief (the first mutating step).", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--name" ], "description": "Project name (free text).", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--slug" ], "description": "Project slug (^[a-z0-9][a-z0-9-]*$).", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--branch-prefix" ], "description": "Branch prefix for worktrees.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--brief" ], "description": "Free-text project description, or @path to read it from a file.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--agents" ], "description": "Comma-separated agent files to emit: claude_code, codex, gemini, cursor, copilot.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--map" ], "description": "Project-relative directory for the project map — discern's agent-maintained documentation tree.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--config" ], "description": "JSON answers file (or - for stdin) to scaffold declaratively.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--model" ], "description": "Your self-declared provider/model identifier, or `unreported`; advisory self-reported setup provenance.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--dry-run" ], "description": "Print the plan and write nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--reseed" ], "description": "Run setup again and refresh discern's files and settings.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--allow-dirty" ], "description": "Advanced/CI: set up on the current branch as-is, skipping the clean-tree check and the isolated discern-setup branch.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--confirmed" ], "description": "Attest you have held the setup consent conversation with your human — required for a fresh, non-declarative begin; its absence re-serves that conversation.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "setup", "step" ], "description": "Re-serve one numbered step of the setup brief (read-only; for a mid-setup re-focus).", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "n", "optional": false, "variadic": false, "value_types": [ "number" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "setup", "done" ], "description": "Prove the committed setup, return canonical Proof and completion inventory, and record [meta].bootstrapped.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--unproven" ], "description": "Record completion without Proof; setup acceptance will refuse it.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "setup", "accept" ], "description": "Land the proved setup branch on the trunk, then return provider activation checks.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Print the plan and change nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "upgrade" ], "description": "Bring this project forward to the installed discern: run pending config migrations, reconcile discern-owned config, .gitignore and .gitattributes blocks, and refresh bundled skills and instructions. Never replaces the binary. Use `discern update` to bring trunk into a task branch; use `discern refresh` to regenerate project artifacts only.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Preview the pending migrations and skills refresh; write nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--check" ], "description": "Report pending managed-version adoption, config migrations, fixed config scaffold or managed-banner drift, and discern-owned .gitignore or .gitattributes block drift; exit non-zero for any; write nothing; no network.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--allow-dirty" ], "description": "Upgrade even with uncommitted changes (skips the clean-tree check).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "uninstall" ], "description": "Remove discern's wiring from this project (keeps your discern.toml, instructions, and map).", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Preview what would be removed and kept; change nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "-y", "--yes" ], "description": "Skip the confirmation.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "doctor" ], "description": "Check the install and Git safety settings, then print each verb's execution model.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "-v", "--verbose" ], "description": "Show the hint explaining each execution-model step (hidden by default).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "releases" ], "description": "Open discern's release information in the browser, see what's changed, and whether an upgrade is available.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Show the release handoff without opening a browser or recording a timestamp.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "licenses" ], "description": "Print discern's licenses and bundled third-party software notices.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "triangle" ], "description": "A small mystery for those who find it.", "aliases": [], "hidden": true, "hidden_when": "always", "stability": "evolving", "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "map" ], "description": "Browse the configured project map that coding agents maintain, or read a named map page.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "target", "optional": true, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--raw" ], "description": "Print a doc's pristine Markdown source instead of rendering it.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--list" ], "description": "Print a plain table of contents and exit without interaction.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--search" ], "description": "Search the map with task language or exact text; use a target to narrow it.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--pager" ], "description": "Open rendered documents in an external pager (uses $PAGER or less -R).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--dir" ], "description": "Map directory to browse (default: the project's [map].dir).", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--width" ], "description": "Wrap width for rendered output.", "type_definition": "", "arity": 1, "value_types": [ "number" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--export" ], "description": "Concatenate Markdown: public, all, select, or a configured scope name.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--output" ], "description": "Write an export to a file instead of stdout.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false } ] }, { "path": [ "docs" ], "description": "Browse the complete bundled product manual, or read a named manual page.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "target", "optional": true, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--raw" ], "description": "Print a doc's pristine Markdown source instead of rendering it.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--list" ], "description": "Print a plain table of contents and exit without interaction.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--search" ], "description": "Search the manual with task language or exact text; use a target to narrow it.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--adr" ], "description": "Browse this project's decision records, or show their published location when local records are unavailable.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--pager" ], "description": "Open rendered documents in an external pager (uses $PAGER or less -R).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--width" ], "description": "Wrap width for rendered output.", "type_definition": "", "arity": 1, "value_types": [ "number" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--export" ], "description": "Concatenate Markdown to stdout: public.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--output" ], "description": "Write an export to a file instead of stdout.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false } ] }, { "path": [ "help" ], "description": "Show command-line help.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "command", "optional": true, "variadic": true, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "config" ], "description": "Edit jobs, scopes, and standards with set-*; edit generated groups, checkpoints, and resources with set ; read or explain discern.toml.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "config", "set-job" ], "description": "Set a gate job. Known names (format, build, lint, typecheck, test, smoke) derive their stage and accept a positional scalar or repeatable ordered --run. Custom names require --stage and --run. Known-job applicability uses --not-applicable or --applicable.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "name", "optional": false, "variadic": false, "value_types": [ "string" ] }, { "name": "command", "optional": true, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--stage" ], "description": "Custom jobs only: when it runs (fix|build|check|test).", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--run" ], "description": "Literal command; repeat to preserve order.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--provides" ], "description": "Custom jobs only: free-text label.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--timeout" ], "description": "Command budget in seconds; 0 removes the bound.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--not-applicable" ], "description": "Known jobs: exclude an absent lifecycle from setup assurance.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--applicable" ], "description": "Known jobs: restore lifecycle applicability.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--inputs" ], "description": "Complete input glob; repeat for every input.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--needs" ], "description": "Required producer selector; repeat for every dependency.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--artifacts" ], "description": "Output artifact path to capture; repeat for every artifact.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--environment" ], "description": "Environment variable name to bind to evidence; repeat for every name.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--toolchain" ], "description": "Toolchain identity file; repeat for every file.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--dry-run" ], "description": "Print the edit and write nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "config", "set-scope" ], "description": "Set a scope — a named region of the repository a change can touch.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "name", "optional": false, "variadic": false, "value_types": [ "string" ] }, { "name": "globs", "optional": false, "variadic": true, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--neutral" ], "description": "Changes here need no gate.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--preview" ], "description": "A read-only command an agent can run to preview changes here.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--gate" ], "description": "A command to run when this scope changed.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--timeout" ], "description": "Per-scope gate-command budget in seconds; 0 removes the bound.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--inputs" ], "description": "Complete input glob; repeat for every input.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--needs" ], "description": "Required producer selector; repeat for every dependency.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--artifacts" ], "description": "Output artifact path to capture; repeat for every artifact.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--environment" ], "description": "Environment variable name to bind to evidence; repeat for every name.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--toolchain" ], "description": "Toolchain identity file; repeat for every file.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--dry-run" ], "description": "Print the edit and write nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "config", "set-standard" ], "description": "Set a quality standard — standards are numbers that can never get worse.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "name", "optional": false, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--limit" ], "description": "The floor (up) or ceiling (down).", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--metric" ], "description": "Metric name the run emits (default: ).", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--direction" ], "description": "Either \"up\" or \"down\".", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--run" ], "description": "The command that emits the metric line.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--producer" ], "description": "Existing producer to consume; mutually exclusive with --run.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--extract" ], "description": "Read metrics from captured producer output or an artifact on stdin.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--artifact" ], "description": "Declared producer artifact supplied to --extract.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--per" ], "description": "Denominator metric, or one built-in extent as files=, lines=, words=, or bytes=.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--scale" ], "description": "Multiply a rate into human units.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--margin" ], "description": "Headroom left when pinning the limit.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--timeout" ], "description": "Measurement-command budget in seconds; 0 removes the bound.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--inputs" ], "description": "Complete input glob; repeat for every input.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--needs" ], "description": "Required producer selector; repeat for every dependency.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--artifacts" ], "description": "Output artifact path to capture; repeat for every artifact.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--environment" ], "description": "Environment variable name to bind to evidence; repeat for every name.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--toolchain" ], "description": "Toolchain identity file; repeat for every file.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--dry-run" ], "description": "Print the edit and write nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "config", "set" ], "description": "Set a config key (section.key). The value's TOML type follows the schema; an array-of-strings key wraps a single value.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "key", "optional": false, "variadic": false, "value_types": [ "string" ] }, { "name": "value", "optional": false, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--number" ], "description": "Treat the value as a number (union-typed keys only).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--bool" ], "description": "Treat the value as a boolean (union-typed keys only).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--string" ], "description": "Treat the value as a string (union-typed keys only).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--dry-run" ], "description": "Print the edit and write nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "config", "get" ], "description": "Print a scalar config value.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "key", "optional": false, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "config", "array" ], "description": "Print an array config value, one item per line.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "key", "optional": false, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "config", "has" ], "description": "Test whether a key or section exists. Bare: print nothing and exit 0/1. JSON: report `data.present` and exit 0.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "key", "optional": false, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "config", "subsections" ], "description": "Print the immediate child table names under a section.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "key", "optional": false, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "config", "keys" ], "description": "Print the flat key names declared in a section.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "key", "optional": false, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "config", "explain" ], "description": "Explain a config section, named-table family, or key: what it governs, why it matters, its keys and defaults, the current value, and worked examples. Works outside a project too.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "path", "optional": false, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "done" ], "description": "Require a clean, committed tree. Run finishing steps that may change files, then verify the gate — the project's full quality check: format, lint, type-check, and tests.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Show the gate plan (the jobs and scope-gates that would run); touch nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--policy-base" ], "description": "Use the fetched immutable policy base for a standalone CI report. Strict completion checks against the trunk's current tip.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--standalone" ], "description": "Run complete diagnostic feedback, including on a dirty tree. Results are transient and issue no Proof.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--rerun" ], "description": "Run the full gate even when current green Proof covers this exact tree, or explicitly retry an unchanged red verdict. The rerun is recorded.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--ci" ], "description": "Run the machine gate and report checkpoint questions without enforcing or recording review. The resulting Proof cannot be accepted.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--met" ], "description": "Declare a served checkpoint's question met (repeatable). Valid only for a checkpoint with an active open question here; the declaration is recorded as your judgment, and the gate runs in the same invocation once every awaiting checkpoint has a conclusion.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--unmet" ], "description": "Declare a served checkpoint's question unmet (one per invocation; requires --why). The gate still runs; landing then needs the owner to authorize a variance for it.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--why" ], "description": "The required rationale for --unmet: one paragraph, 1-500 characters, no newlines or control characters. Recorded opaquely as Proof evidence for the owner's landing decision.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false } ] }, { "path": [ "prepare" ], "description": "Fast inner loop: fixers, [generated] regenerations, complete refresh, then read-only checks (no other build jobs, no tests).", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "test" ], "description": "Run the project's configured tests on their own, outside the full gate.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "queue" ], "description": "Run a command while holding one configured concurrent test-run slot. Use `discern await` to watch a fleet condition instead. This command has no `--json`, `--markdown`, or `--render` mode; tokens after `--` belong to the child.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "-- [args...]", "flags": [] }, { "path": [ "improvement" ], "description": "Find the highest-value next improvement, with the health audit and open reviews for agent and owner to evaluate together.", "aliases": [], "hidden": false, "hidden_when": null, "stability": "evolving", "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--category" ], "description": "Review a single area (gate, setup, instructions, map, worktrees, standards, checkpoints, skills).", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--min-score" ], "description": "Exit non-zero when the overall score is below this floor (a CI/agent gate).", "type_definition": "", "arity": 1, "value_types": [ "number" ], "default": null, "hidden": false, "global": false } ] }, { "path": [ "checkpoints" ], "description": "Report the governing checkpoint policy, each open question's declaration state, and a read-only preview of what the current change would fire. Nothing runs and nothing is recorded.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "progress" ], "description": "Read a long operation back after a lost call: its phase, the counts and failures known so far, and the retained result. Pass the progress handle the operation announced; with no handle, read this checkout's most recently started operation. Reading changes nothing.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "handle", "optional": true, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "mcp" ], "description": "The stdio MCP server, exposing the verbs to an agent as tools. You don't usually need to run this; agents should connect automatically.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--long-tool-calls" ], "description": "Use the long-call transport profile; await calls may run for 3300 seconds.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--strict-tool-calls" ], "description": "Use the strict transport profile; await calls may run for 45 seconds.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "scripts" ], "description": "List executable Project Scripts, or run one literal name at the project root with the four supported DISCERN_* variables and every following argument forwarded unchanged.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "name", "optional": true, "variadic": false, "value_types": [ "string" ] }, { "name": "args", "optional": true, "variadic": true, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "standards" ], "description": "Measure the named quality standards, or every configured standard when no names are given: numbers that can never get worse. `discern done` already verifies and measures them on every run. Authoring one? Hold a rate (`per`) for a number that rises as the project grows, and give a drifting total a `margin` — a ceiling pinned at today's value fails the next legitimate change.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "names", "optional": true, "variadic": true, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Show the standards that would be measured; touch nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--force" ], "description": "Run standards on a dirty worktree; intended only while authoring standards.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--pin" ], "description": "Capture measured improvements for the named standards, or every one with slack. Same-commit values are reused; named measurement narrows only when gate Proof already validates the clean tree. Commit the limit change alone and carry Proof forward. Requires a clean worktree.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "standards", "propose" ], "description": "Finalize a proposed limit for a standard breached by this change. On a clean final HEAD, measure the named standard, then create its config-only proposal commit or renew an unchanged descendant binding. Acceptance still requires explicit approval for the value and reason.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "name", "optional": false, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--reason" ], "description": "The exact non-empty owner-facing reason for the standard limit proposal (1-500 visible, secret-free characters).", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--dry-run" ], "description": "Show the proposal plan; touch nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "refresh" ], "description": "Refresh the agent files, skills, provider integrations, and the maintained ADR index. Use `discern update` for this branch; use `discern upgrade` for discern itself.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "List every refresh target and create/update/remove effect; change nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "tidy" ], "description": "Canonically format discern's configured Markdown sources and root discern.toml, and check that fenced box-drawing diagrams stay aligned. Select `md` or `toml`; omit the type to run both. A Markdown file whose frontmatter is not valid YAML, or whose table rows would drop cells when formatted (escape pipes inside code spans as `\\|`), is refused and left unchanged.", "aliases": [], "hidden": false, "hidden_when": null, "stability": "evolving", "positionals": [ { "name": "type", "optional": true, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "List the files that would change; touch nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "skills" ], "description": "Manage skills: list the effective set, or eject a built-in to customize it.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "skills", "list" ], "description": "List the effective skills (built-ins + yours; which override which).", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "skills", "eject" ], "description": "Copy a bundled built-in into [skills].dir so you can customize it.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "name", "optional": false, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Preview every ejection and materialization target without changing it.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "impact" ], "description": "Show which configured scopes the branch and working tree wake in the quality gate. Scopes are named regions of the repository with their own gate jobs. With --has, JSON reports data.membership and exits successfully for either Boolean value.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--has" ], "description": "Test one scope. Bare: print nothing and exit 0/1. JSON: report `data.membership` and exit 0.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false } ] }, { "path": [ "coupling" ], "description": "Report files that historically change together as a read-only advisory. With no args, report likely siblings missing from the change. With file, report its top partners. Add with to report commits where both changed.", "aliases": [], "hidden": false, "hidden_when": null, "stability": "evolving", "positionals": [ { "name": "file", "optional": true, "variadic": false, "value_types": [ "string" ] }, { "name": "with", "optional": true, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "await" ], "description": "Block until a fleet condition holds: a sibling branch is green (its worktree holds an honored gate Proof), a branch's work has landed on the trunk, or the trunk has moved. Timing out is not an error; the result carries a short continuation handle that preserves the original condition across calls. To wrap a command behind the concurrent test-run cap, use `discern queue -- [args...]`.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--green" ], "description": "Select a sibling by worktree id, path, local branch, or full local ref; wait until its checkout holds an honored gate Proof (a landing also satisfies it).", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--landed" ], "description": "Select a sibling by worktree id, path, local branch, or full local ref; wait until its work reaches the trunk.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--trunk-moved" ], "description": "Wait until the trunk ref moves from its position at call start.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--resume" ], "description": "Continue a previous not-met wait without resetting its pinned state; pass no condition flag with it.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--timeout" ], "description": "Seconds before answering \"not yet\". Omit to wait once for up to 3300s; the condition returns early, and 0 checks once.", "type_definition": "", "arity": 1, "value_types": [ "number" ], "default": null, "hidden": false, "global": false } ] }, { "path": [ "patterns" ], "description": "Report the patterns in this project's discern use, read from the local logbook: validation, evidence reuse, waits, landing latency, gate fit and standard trends. Counts include observation limits. A read-only advisory.", "aliases": [], "hidden": false, "hidden_when": null, "stability": "evolving", "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--stats" ], "description": "Report practice stats instead: changes accepted, green streaks, cycle times, standards trends, and agent cohorts, counted from the same local evidence. With --json, the counts join the result as data.stats.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--all" ], "description": "Report every finding from every detector.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--logbook-file" ], "description": "Read one sealed archive basename listed by `discern patterns archives` instead of the active logbook.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false } ] }, { "path": [ "patterns", "archives" ], "description": "List sealed logbook archives with their event counts, date spans, and byte sizes.", "aliases": [], "hidden": false, "hidden_when": null, "stability": "evolving", "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "patterns", "reset" ], "description": "Permanently remove the active logbook after terminal confirmation. Sealed archives and other Git-admin state remain. A dry-run previews one result; apply is refused with --json or --markdown.", "aliases": [], "hidden": false, "hidden_when": null, "stability": "evolving", "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Render the complete plan without requesting confirmation or changing files.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "patterns", "seal" ], "description": "Seal the active event history into a timestamped archive and begin a fresh active logbook after terminal confirmation. A dry-run previews one result; apply is refused with --json or --markdown.", "aliases": [], "hidden": false, "hidden_when": null, "stability": "evolving", "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Render the complete plan without requesting confirmation or changing files.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "status" ], "description": "Show what's true right now and what to do next (read-only; does not run the gate, the project's full quality check).", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--all" ], "description": "Include every worktree even when called from one (local view plus all worktrees).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--local" ], "description": "Show only this checkout, even in the main checkout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "-v", "--verbose" ], "description": "Expand fleet attention, per-worktree evidence, configured checks, landing history, and full Proof pages. With JSON, return complete structured status; the default is the bounded orientation projection.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "desk" ], "description": "Open the live desk: see tasks, review Proof and changes, open an agent, run Project Scripts, or review acceptance and worktree controls. Bare `discern` opens the desk. The desk is interactive only; use status --markdown or status --json to list every worktree.", "aliases": [], "hidden": false, "hidden_when": null, "stability": "evolving", "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "enter" ], "description": "Choose a worktree and open a child shell at the matching project-relative directory. This command is interactive only; use status --all --json to inspect the fleet.", "aliases": [], "hidden": false, "hidden_when": null, "stability": "evolving", "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "start" ], "description": "From the main checkout, create a worktree with a separate checkout and branch for one effort. Base it on the trunk, the shared landing branch, then print its path.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Show the start plan; touch nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--name" ], "description": "Set the task title and seed its worktree id. discern preserves this text as the title and normalizes the id. Omit for a random codename.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--title" ], "description": "Set the display title separately from --name. With no --name, the title also seeds the worktree id.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--brief" ], "description": "Store an optional one-line brief for task detail and agent handoff.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--from" ], "description": "Branch the new worktree from a ref or an unambiguous worktree id or path. Omit it to start from the trunk.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false } ] }, { "path": [ "accept" ], "description": "Submit this worktree's proven commit and land it on the trunk, the shared landing branch. Landing needs the owner's consent in this conversation or a recorded grant; without one, the submission waits in the landing queue. If the trunk moved after the Proof, the landing composes and checks the combined code in a disposable integration worktree and lands that exact proven commit; a second accept waits its turn. Landing removes the worktree and its branch when the branch holds nothing beyond the landed commit. Use accept emergency --reason to review an explicit exception against actual trunk. Emergency integration requires fresh exact owner confirmation and issues no passing Proof.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "action", "optional": true, "variadic": false, "value_types": [ "accept-action" ], "choices": [ "emergency", "queue" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Show the selected acceptance plan; touch nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--target" ], "description": "Select the effort by id, path, or branch, from any checkout. With accept queue, record its current proven revision; otherwise start landing under applicable authority.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--prepare" ], "description": "Emergency only: run checkpoint triggers and retain exact review evidence without validation or integration.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--preparation-receipt" ], "description": "Emergency only: the checkpoint-preparation receipt for this exact repair and trunk.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--met" ], "description": "Record a satisfied served checkpoint question (repeatable): the continuation of a landing whose combined result awaits your judgment, or emergency preparation with accept emergency --prepare.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--unmet" ], "description": "Declare one served integration checkpoint question not satisfied (requires --why). The retained composition is still proved; the owner then decides the declared-unmet landing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--why" ], "description": "The required one-paragraph rationale for --unmet.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--composition-receipt" ], "description": "The served composition receipt an answer or resumed variance decision binds to; the judgment refusal serves it. A replaced composition refuses the receipt and re-serves its own question.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--reason" ], "description": "Emergency only: explain why integration must precede validation.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--approval-token" ], "description": "Emergency only: the current preview token approved by the owner, with --confirmed.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--recover" ], "description": "Emergency only: reconcile one recorded exception transition and cleanup without new landing authority.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--confirmed" ], "description": "Attest that your owner accepted this landing in the current conversation. Recorded standing and effort grants are checked directly. Consent bound to an interrupted transaction may authorize recovery of that transaction only. Without applicable evidence, acceptance refuses read-only; a dry-run needs none.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--variance" ], "description": "Record that your owner authorized landing this declared-unmet checkpoint without changing it (repeatable; requires --confirmed). The ids must equal the current declared-unmet set, id for id, and recorded grants never authorize a variance.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--approve-standard" ], "description": "Record that the owner approved the exact standard/value/reason tuple carried by the current Proof (repeatable; requires --confirmed). Use the proposal-bound token served by the read-only refusal; the token set must equal the current proposal set. Standing, effort, and generic landing grants never authorize a standard limit proposal.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false } ] }, { "path": [ "update" ], "description": "Update this branch: merge the trunk's latest into this branch and re-run generated groups and refresh Agent artifacts. The trunk is the shared landing branch. Use `discern upgrade` for discern itself; use `discern refresh` for agent files alone.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Show the update plan; touch nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--from" ], "description": "Pull a ref or an unambiguous worktree id or path into this worktree instead of the trunk. For composing on unlanded work — omit it for the routine bring-the-trunk-in call.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false } ] }, { "path": [ "identity" ], "description": "Print stable values that keep each checkout's branch, development host, port, database, and external resources separate.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "worktree", "optional": true, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--id" ], "description": "Print the safe base name for this checkout (default).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--site" ], "description": "Print its development server's host name.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--branch" ], "description": "Print its branch name.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--port" ], "description": "Print its stable development-server port.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--db" ], "description": "Print its database-safe name.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--seed" ], "description": "Print its stable test-order seed.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--worktree" ], "description": "Print its base resource handle — a stable project-prefixed external name.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--resource" ], "description": "Print the stable external name for one declared resource.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--resources" ], "description": "Print every declared resource as name=stable-external-name lines.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "worktree" ], "description": "Manage worktrees — separate checkouts and branches for individual changes.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "worktree", "setup" ], "description": "Set up or re-sync the current worktree.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Show the setup plan; touch nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--mark-step-complete" ], "description": "After observing an interrupted setup command's external state, mark its running journal entry complete without replaying it.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--retry-step" ], "description": "After observing an interrupted setup command's external state, reset its running journal entry and run it again.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": false }, { "spellings": [ "--confirmed" ], "description": "Attest that the owner observed the interrupted command's external state and chose this recovery. Required with either recovery option.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "worktree", "ensure" ], "description": "Idempotent session-start worktree setup.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "worktree", "rename" ], "description": "Change this worktree's display title. Its id, branch, path, brief, and creation source stay unchanged.", "aliases": [], "hidden": false, "hidden_when": null, "stability": "evolving", "positionals": [ { "name": "title", "optional": false, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Show the title-change plan; touch nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "worktree", "teardown" ], "description": "Discard this worktree's resources (destroy without accepting).", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Show the teardown plan; touch nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "worktree", "park" ], "description": "Remove a clean task checkout and its resources while retaining its branch and task wording for resume. Select it by worktree id, path, local branch, or full local ref.", "aliases": [], "hidden": false, "hidden_when": null, "stability": "evolving", "positionals": [ { "name": "worktree", "optional": false, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--dry-run" ], "description": "Show the Park plan; touch nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "worktree", "drop" ], "description": "Discard a worktree from the main checkout: tear down its resources, remove it, and delete its branch. Protects uncommitted work and commits not on the trunk, the shared landing branch, unless --force is set. Select it by worktree id, path, local branch, or full local ref.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [ { "name": "worktree", "optional": false, "variadic": false, "value_types": [ "string" ] } ], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "--force" ], "description": "Discard even when the worktree holds uncommitted changes or commits not on the trunk.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--dry-run" ], "description": "Show the drop plan; touch nothing.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "worktree", "prune" ], "description": "Reclaim positively-owned merged worktrees, stale state, reappeared paths, and orphaned resources.", "aliases": [], "hidden": false, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true }, { "spellings": [ "-y", "--yes" ], "description": "Non-interactive: skip confirmation.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--contained" ], "description": "Also reclaim contained worktrees — checkouts whose committed work is fully contained in another live branch. Branch refs are always kept.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false }, { "spellings": [ "--dry-run" ], "description": "Report what would be removed/reclaimed without acting.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": false } ] }, { "path": [ "worktree", "hook" ], "description": "Provider hook entry points (machine-invoked; stdin carries the hook payload).", "aliases": [], "hidden": true, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "worktree", "hook", "create" ], "description": "Create a worktree from a provider WorktreeCreate payload on stdin.", "aliases": [], "hidden": true, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] }, { "path": [ "worktree", "hook", "remove" ], "description": "Tear down the worktree named by a provider WorktreeRemove payload on stdin.", "aliases": [], "hidden": true, "hidden_when": null, "positionals": [], "usage": "", "flags": [ { "spellings": [ "--json" ], "description": "Emit one JSON result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--markdown" ], "description": "Emit one Markdown result on stdout.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--render" ], "description": "Render the Markdown result as terminal output.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--no-color" ], "description": "Disable color (also honors NO_COLOR and non-TTY output).", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--plain" ], "description": "Disable interactive input and paging; use static output. CI and non-terminal input imply this behavior.", "type_definition": "", "arity": 0, "value_types": [], "default": null, "hidden": false, "global": true }, { "spellings": [ "--theme" ], "description": "Set the terminal theme to `auto`, `light`, or `dark`. Default: `auto`. The automatic mode senses a colored interactive background; `--no-color` and `NO_COLOR` skip sensing.", "type_definition": "", "arity": 1, "value_types": [ "string" ], "default": null, "hidden": false, "global": true } ] } ] }