> ## Documentation Index
> Fetch the complete documentation index at: https://stampede.autonomousorganizations.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI reference

> Every stampede subcommand and flag in v0.5.3, grouped by task, and the slash commands of the console.

Every Stampede action is a `stampede` subcommand or a slash command typed in the console. This page lists them all for v0.5.3, one line each. `UPPERCASE` words are values you supply; `[ ]` marks an optional part; `a|b` means one of the listed values. The same text is available offline with `/help QUERY` in the console.

## Global flags

These flags go before or after the subcommand and apply to the commands that run as a person.

| Flag | Meaning |
| - | - |
| `--person NAME` | Run as this person instead of the default one. `STAMPEDE_PERSON` does the same. |
| `--skill-lane stable` or `--skill-lane canary` | Which activation lane of learned skills the run may use. |
| `--version` | Print the binary version and exit. |

Commands that change persons, schedules, nodes, services, configuration or stored state are refused when started from inside a Stampede run (by a tool's `run_command`); reads still work.

## Console and one-shot runs

* `stampede [--person NAME]`: open the console. The TUI when stdin and stdout are both a terminal, the line chat otherwise; `console = "chat"` in `config.toml` makes the line chat the default. Resumes the last conversation when `resume_by_default = true`.
* `stampede chat [--person NAME] [--skill-lane stable|canary]`: start a fresh line chat.
* `stampede tui [--person NAME] [--skill-lane stable|canary]`: start a fresh full-screen conversation.
* `stampede resume [NAME]`: resume a saved conversation of the active person, the last one when no name is given.
* `stampede -prompt "QUESTION"`: ask one question, print one answer, exit.
* `stampede agent [--ephemeral] [--skill-lane stable|canary] "TASK"`: run an autonomous task. Durable (journaled and resumable) by default; `--ephemeral` runs it without durable recovery.

## Runs and sessions

* `stampede runs list [--person NAME]`: list recent durable runs, optionally for one person.
* `stampede runs show RUN_ID [--tokens]`: show a run's redacted record; `--tokens` adds the token and cache figures per model call.
* `stampede runs resume RUN_ID`: resume a run that can be recovered safely.
* `stampede runs conclude RUN_ID`: finish a recoverable run with a summary, without running more tools.
* `stampede runs cancel RUN_ID`: request cancellation of a run.
* `stampede runs gc`: run one bounded garbage-collection pass over stored run artifacts.
* `stampede sessions list`: list saved conversation names.
* `stampede sessions export NAME PATH`: export a saved conversation to a file.
* `stampede sessions import PATH NAME`: import a conversation under a name.
* `stampede usage [--since 24h|7d|YYYY-MM-DD] [--profile NAME] [--person NAME]`: token and cost totals per model profile from the run ledger.

## Persons

* `stampede person list`: list the persons of the home with their presets.
* `stampede person show NAME`: show one person's profile and effective tools and programs.
* `stampede person use NAME`: set the default person for future conversations.
* `stampede person create NAME [--purpose TEXT] [--identity-file 0600_PATH] [--model PROFILE] [--policy research|writer|reviewer|coordinator|builder|maintainer|free] [--allow-tool NAME] [--allow-command PROGRAM] [--max-hops 1-256] [--operation-id 64_HEX]`: create a person. Without `--policy` the person is free (every tool, any program).
* `stampede person edit NAME [--purpose TEXT|--clear-purpose] [--identity-file 0600_PATH|--clear-identity] [--model PROFILE|--clear-model] [--operation-id 64_HEX]`: change a person's purpose, identity text or model for future runs.
* `stampede person policy NAME research|writer|reviewer|coordinator|builder|maintainer|free [--allow-tool NAME] [--allow-command PROGRAM] [--max-hops 1-256] [--operation-id 64_HEX]`: replace a person's policy.
* `stampede person send --from NAME --to NAME --intent request|inform|ack --body-file 0600_PATH [--operation-id 64_HEX]`: send mail from one person to another.
* `stampede person inbox NAME [--ack]`: inspect a person's mailbox; `--ack` acknowledges its messages.
* `stampede person runs [NAME]`: list the durable runs of one person.
* `stampede person goals [NAME]`: list the goals of one person.

`--identity-file`, `--body-file` and `--task-file` take a file with mode 0600. `--operation-id` makes a repeated command a no-op instead of a duplicate.

## Schedules

* `stampede person schedule create PERSON NAME (--every Nm|Nh|Nd|--cron "FIVE FIELDS") --task-file 0600_PATH [--disabled] [--operation-id 64_HEX]`: create an interval or five-field UTC cron job for a person.
* `stampede person schedule list [PERSON]`: list schedules without their task text.
* `stampede person schedule show PERSON NAME`: show one schedule with its task text.
* `stampede person schedule pause PERSON NAME [--operation-id 64_HEX]`: stop future fires.
* `stampede person schedule resume PERSON NAME [--operation-id 64_HEX]`: resume future fires.
* `stampede person schedule remove PERSON NAME [--operation-id 64_HEX]`: delete a schedule.
* `stampede person schedule serve [--once] [--poll-seconds 1-300]`: run the schedule worker in the foreground. The `schedule` service runs this for you.

## Task rooms

* `stampede room list`: list task rooms with their state, coordinator, members and counts.
* `stampede room show ROOM_ID`: print one room with each member's presence and its posts.

Both print decrypted room messages and warn on stderr.

## Machines and remote rooms

* `stampede node init NAME --listen IP:PORT --advertise IP:PORT`: create this machine's node identity and public card.
* `stampede node show [--output 0600_PATH]`: print this node's card, or write it to a file.
* `stampede node peer add CARD [--policy research|builder|free|operator]`: pin a peer and set the highest authority it may use here.
* `stampede node peer list`: list pinned peers and their ceilings.
* `stampede node peer remove NAME`: revoke a peer for future requests.
* `stampede node serve`: serve inbound requests in the foreground. The `node` service runs this for you.
* `stampede node send PEER PERSON --from LOCAL_PERSON --task-file 0600_PATH [--budget-file 0600_JSON] [--request-id 64_HEX]`: send a task to a person on a peer and stream its progress until the report.
* `stampede node status PEER REQUEST_ID`: show a request's local record and the peer's progress.
* `stampede node cancel PEER REQUEST_ID`: stop a request, locally while queued or at the peer once it holds it.
* `stampede node queue`: list every request this machine has not finished delivering or following.
* `stampede node room create NAME`: create an encrypted room of persons on pinned peers.
* `stampede node room add ROOM PEER PERSON`: add a person on a peer to a room.
* `stampede node room remove ROOM PEER PERSON`: remove a person from a room.
* `stampede node room list`: list remote rooms.
* `stampede node room show NAME`: show a room's members.
* `stampede node room delete NAME`: archive a room and stop new dispatches.
* `stampede node room send ROOM --from LOCAL_PERSON --task-file 0600_PATH [--budget-file 0600_JSON] [--request-id 64_HEX]`: send one task to every member, each with a share of the budget.
* `stampede node room status ROOM DISPATCH_ID`: show each member's state and budget use for one dispatch.
* `stampede node room cancel ROOM DISPATCH_ID`: cancel every unfinished member of a dispatch.
* `stampede node room resume ROOM DISPATCH_ID`: resume an interrupted dispatch.

## Installation and services

* `stampede init [--tools-full-access true|false] [--tools-write-path PATH ...]`: create or complete `~/.stampede` with default profiles, an explicit `[tools]` posture and owner-only modes. `--tools-full-access` defaults to `true`; `--tools-write-path` takes an absolute path and may repeat.
* `stampede doctor [--offline]`: report the health of the installation, one row per check; exits 1 on any failed row. `--offline` skips network checks.
* `stampede service install [--print]`: write the supervisor units and start every configured worker; `--print` prints the units instead.
* `stampede service status`: one line per worker; exits 0 only when every installed worker runs.
* `stampede service start [WORKER]`, `stop [WORKER]`, `restart [WORKER]`: control one worker or all.
* `stampede service reload [gateway]`: make the running gateway re-read its member and group lists.
* `stampede service uninstall [WORKER]`: stop and unregister workers and remove their units.
* `stampede service uninstall --orphans [--dry-run]`: remove registrations of homes that no longer exist.
* `stampede service run node|schedule|gateway|webhook`: run one worker in the foreground the way its unit does.

`WORKER` is `node`, `schedule`, `gateway` or `webhook`. See [Services and doctor](https://stampede.autonomousorganizations.ai/production/services-and-doctor.md).

## Telegram gateway

* `stampede gateway pending`: list the Telegram accounts that sent `/start` to the bot without being members.
* `stampede gateway pending clear [ID]`: remove one pending sender, or all.
* `stampede gateway member add ID PERSON [--purpose TEXT]`: add a member to `[gateway.telegram]`, creating its requester person, without a restart.

## Webhooks

* `stampede webhook list`: list webhook deliveries.
* `stampede webhook show RUN_ID`: show one delivery and its result, through the outbound filter.
* `stampede webhook routes`: list the configured routes and whether their vault entries are present.

## Memory

* `stampede memory list [--scope SCOPE] [--state STATE] [--after CURSOR] [--limit N]`: list memory records without their content.
* `stampede memory show ID REVISION`: show one exact memory version, decrypted, with a warning.
* `stampede memory propose --scope SCOPE --kind KIND (--content TEXT|--content-file PATH|--content-stdin) [OPTIONS]`: add an inactive memory candidate.
* `stampede memory review ID REVISION activate|reject [OPTIONS]`: activate or reject a candidate.
* `stampede memory forget (--version ID REV|--key SCOPE KEY|--scope SCOPE|--all --confirm-all)`: stop memory from being retrieved.
* `stampede memory purge (--version ID REV|--key SCOPE KEY|--scope SCOPE|--all --confirm-all) --confirm-purge`: physically delete memory and what depends on it.
* `stampede memory purge-status PURGE_ID`: inspect a purge.
* `stampede memory export PATH`: export memory to a plain-text portable file.
* `stampede memory import PATH`: import portable memory as inactive candidates.

## Skills

* `stampede skills install SOURCE [--scope user|project] [--name NAME] [--trigger T]... [--path SUBDIR] [--ref REF] [--dry-run] [--confirm-install]`: install a skill from a Markdown file, an Agent Skills folder or a git URL, after showing it and running a smoke test.
* `stampede skills list [--scope SCOPE] [--state STATE] [--after CURSOR] [--limit N]`: list skills.
* `stampede skills candidates [--scope SCOPE] [--after CURSOR] [--limit N]`: list inactive candidates.
* `stampede skills show ID VERSION`: show one exact skill version, decrypted, with a warning.
* `stampede skills diff ID LEFT_VERSION RIGHT_VERSION`: compare two versions of a skill.
* `stampede skills propose --file PATH --confirm-propose`: submit a new skill version from a private JSON file.
* `stampede skills import-legacy --directory PATH --scope project|user|global --confirm-import`: import old Markdown procedures as inactive candidates.
* `stampede skills test ID VERSION --suite-file PATH`: run comparative validation for a candidate, or monitor a canary.
* `stampede skills approve ID VERSION (--rationale-file PATH|--rationale-stdin) --confirm-review [--waive-comparative]`: approve a candidate.
* `stampede skills reject ID VERSION (--rationale-file PATH|--rationale-stdin) --confirm-review`: reject a candidate.
* `stampede skills activate ID VERSION --confirm-activate [--mode canary|stable] [--minimum-trials N] [--minimum-lcb-uplift-micros N]`: activate an approved version.
* `stampede skills deprecate ID VERSION (--rationale-file PATH|--rationale-stdin) --confirm-deprecate`: deprecate a version.
* `stampede skills rollback ID CURRENT_VERSION TARGET_VERSION (--rationale-file PATH|--rationale-stdin) --confirm-rollback`: roll back an active stable version.
* `stampede skills outcome add --evidence-file PATH --confirm-outcome [--operation-id UUID --outcome-id UUID]`: import an outcome attributed to recorded skill uses.
* `stampede skills uses [--version ID VERSION] [--root-run ID] [--after CURSOR] [--limit N]`: list recorded skill uses.
* `stampede skills outcomes [--version ID VERSION] [--root-run ID] [--after CURSOR] [--limit N]`: list learning outcomes.
* `stampede feedback add --version ID VERSION --use USE_ID --root-run ROOT --run RUN --event EVENT --signal SIGNAL (--rationale-file PATH|--rationale-stdin) --confirm-feedback [--operation-id UUID --feedback-id UUID]`: add feedback for one recorded skill use.
* `stampede feedback list [--version ID VERSION] [--root-run ID] [--after CURSOR] [--limit N]`: list skill feedback.

## Goals

* `stampede goals list [--person NAME] [--status STATUS] [--scope KIND --scope-key KEY] [--after CURSOR] [--limit N]`: list goals.
* `stampede goals show GOAL_ID`: show one goal.
* `stampede goals create --label LABEL --objective TEXT --criterion TEXT [--criterion TEXT ...] [--id ID] [--depends-on ID ...] [--parent ID] [--scope KIND --scope-key KEY]`: create a goal with its success criteria.
* `stampede goals import PATH [--as GOAL_ID]`: import a portable goal as unreviewed content.
* `stampede goals export GOAL_ID PATH`: export a goal definition.
* `stampede goals resume GOAL_ID`: resume a goal's active episode or start its next one.
* `stampede goals reopen GOAL_ID`: reopen a goal.
* `stampede goals abandon GOAL_ID`: abandon a goal.
* `stampede goals checkpoint GOAL_ID --criterion CRITERION_ID (--satisfied|--unsatisfied) --evidence-kind KIND --run RUN_ID --event SEQUENCE [OPTIONS]`: record progress on a criterion with evidence from a run.
* `stampede goals complete GOAL_ID [--override-reason REASON]`: complete a goal once its criteria are evidenced.

## Console commands

Type these in the console. The TUI accepts all of them; the line chat accepts all except `/cost`, `/room` and `/node`.

| Command | Meaning |
| - | - |
| `/help [QUERY]` | List the commands, or show one command's syntax and examples. |
| `/model [NAME\|NUMBER]` | List the model profiles, or switch this conversation to one. |
| `/skill NAME [text]` | Load one active skill, a user-only one included, for the next turn. |
| `/skills ...` | The `stampede skills` commands, except `install`. |
| `/feedback ...` | The `stampede feedback` commands. |
| `/save NAME` | Name the current conversation so `stampede resume NAME` finds it. |
| `/sessions` | List saved conversations. |
| `/reflect [save]` | Produce a reflection report with no tools; `save` proposes memory and skill candidates from it. |
| `/allow PATH` | Grant read and write access to a path for this session. |
| `/add-secret NAME=VALUE` | Store a value in the encrypted vault. |
| `/secrets` | List stored secret names. |
| `/rm-secret NAME` | Remove a secret. |
| `/cost` | Token and cost totals of this console's own runs. |
| `/person ...` | The `stampede person` commands, with `/person` alone showing the active person. |
| `/room ...` | The `stampede node room` commands. |
| `/node queue` | The same as `stampede node queue`. |
| `@person REQUEST` | Route a request to a local person. |
| `@node@person REQUEST` | Route a request to a person on a pinned machine. |
| `#room REQUEST` | Send a request to every member of a remote room. |
| `exit` or `quit` | Leave the console. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.