Skip to main content
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. 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.

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.