The complete Jeden CLI.

Interactive root and global options#

Running jeden without a command opens the interactive terminal. --cwd path, --model name, --max-tokens n, --max-steps n, --allow-write, --allow-command, and --yolo/--auto-approve configure that root invocation. --version/-V prints the compiled version and --help/-h prints usage.

Unknown commands and unknown global options fail instead of falling through. Environment files load from the selected workspace before dispatched commands run.

jeden [--cwd path] [--model name] [--max-tokens n] [--allow-write] [--allow-command] [--yolo|--auto-approve] [--max-steps n]

Run and automation#

• jeden run — Run one concrete agent task through a durable Jeden conversation.
• jeden pursue — Turn a rough objective into a source-grounded autonomous contract, execution, independent review, verdict, and receipt.
• jeden rpc — Serve Jeden's newline-delimited JSON RPC interface on standard input and output.
• jeden headless — Serve the multi-tenant Jeden RPC service over a mutually authenticated TLS listener.
• jeden acp — Serve Jeden as an Agent Client Protocol agent over standard input and output.
• jeden collab-relay — Run the encrypted collaboration-room relay used by interactive collaboration commands.

Sessions and artifacts#

• jeden sessions — List locally stored Jeden session identifiers.
• jeden show — Render one durable session export as JSON on stdout.
• jeden export — Export a recorded session as JSON, HTML, or Markdown.
• jeden artifacts — List files in one session's artifact directory.
• jeden artifact — Read one UTF-8 session artifact or copy it to a requested output file.
• jeden search-sessions — Search durable session event payloads for a case-insensitive text fragment.
• jeden resume — Seed a fresh Jeden session with the conversation turns from a recorded session and optionally continue it immediately.
• jeden recall_conversation — Render a recorded session's full event transcript as Markdown for recall or inspection.

Runtime and operations#

• jeden tools — Inspect the currently visible and executable Jeden tool registry.
• jeden update — Transactionally install a signed Jeden release and verify the activated binary before committing it.
• jeden doctor — Probe the live health of Jeden's configured runtime dependencies and local subsystems.
• jeden conformance — Evaluate Jeden's canonical completion areas, production scopes, evidence, and UI-honesty contract.
• jeden probierz — Run Probierz discovery, evidence, and gate commands with the active Jeden executable and model configuration.
• jeden capabilities — Inspect Jeden's atomic capability-discovery and health snapshot.
• jeden token — Print the agent's own Brama credential for shell scripting, redacted unless explicitly revealed.
• jeden stats — Show local usage, quota, and session totals or serve the same snapshot as a loopback dashboard.
• jeden gallery — Render the TUI component gallery under the effective theme or every bundled preset.
• jeden copy — Hand an exact payload to the operator's clipboard from outside an interactive session.

Configuration#

• jeden workspace — Inspect, validate, or adopt an existing local repository as Jeden's default workspace.
• jeden workspace status — Show the currently adopted workspace and the existing sessions associated with it.
• jeden workspace discover — Validate an existing workspace and preview the state Jeden would adopt.
• jeden workspace adopt — Persist an existing local repository as the default workspace used by the next Jeden task.
• jeden config — Inspect and change Jeden's schema-backed user configuration.
• jeden config list — List every schema-backed setting and its effective value.
• jeden config path — Print the writable user configuration file path.
• jeden config get — Read one effective schema-backed setting.
• jeden config set — Validate and persist one user configuration setting.
• jeden config reset — Persist one setting's schema default into the user configuration.
• jeden contracts — Print Jeden's contracts as one text, and install them into another harness's system prompt.

Shell completions#

• jeden completions — Generate a shell-completion program from Jeden's current CLI usage and builtin slash-command registry.
• jeden completions bash — Generate Jeden completions for bash.
• jeden completions zsh — Generate Jeden completions for zsh.
• jeden completions fish — Generate Jeden completions for fish.

Retained tasks#

• jeden todo — Inspect and control every retained user request and its verified task state.
• jeden todo list — Read retained requests, tasks, acceptance requirements and completion evidence.
• jeden todo add — Record a user request without executing it or inventing its acceptance result.
• jeden todo pause — Pause retained work without losing it.
• jeden todo resume — Make paused retained work eligible to run again.
• jeden todo cancel — Withdraw exactly the work the operator selected.
• jeden todo continue — Inspect previous results and continue retained work without adding a synthetic user request.

Managed worktrees#

• jeden worktree — Inspect or safely clear stale Git worktrees owned by Jeden's task runtime.
• jeden worktree list — List Git worktrees correlated with Jeden task records.
• jeden worktree clear — Remove stale, safely bounded Git worktrees owned by Jeden.

Roadmap#

• jeden roadmap — Read and transactionally mutate the repository-owned Jeden roadmap.
• jeden roadmap list — List roadmap items, optionally filtered by exact status, area, or priority.
• jeden roadmap show — Show one roadmap item by case-insensitive ID.
• jeden roadmap add — Create a new validated roadmap item.
• jeden roadmap drop — Mark an item dropped.
• jeden roadmap start — Mark an item in progress.
• jeden roadmap implemented — Mark an item implemented but not yet passed.
• jeden roadmap block — Mark an item externally blocked and record what must change outside the repository.
• jeden roadmap pass — Mark an item passed with evidence.
• jeden roadmap status — Set an item's explicit roadmap status.
• jeden roadmap depends — Add a dependency edge.
• jeden roadmap undepends — Remove a dependency edge.
• jeden roadmap graph — Render the roadmap dependency graph.
• jeden roadmap acceptance — Inspect acceptance criteria or attach new criteria and criterion-specific evidence.
• jeden roadmap acceptance list — List one item's acceptance criteria and attached evidence counts.
• jeden roadmap acceptance add — Append an acceptance criterion to one roadmap item.
• jeden roadmap acceptance evidence — Attach one artifact URI to a specific acceptance criterion.
• jeden roadmap check — Validate the complete roadmap without mutating it.
• jeden roadmap work — Activate one eligible roadmap item as the current goal, plan, todo set, and session work context.