smithersai

smithers-agents

Inspect and register subscriptions and api keys. Run `smithers agents --help` for usage details.

smithers-claude

Protocol commands for the Claude Code plugin: mirror runs into /workflows and notify the session. Run `smithers claude --help` for usage details.

smithers-init

Install the local Smithers workflow pack into .smithers/. Pass an optional prompt to also launch the create-workflow builder after init. Run `smithers init --help` for usage details.

Build a new Smithers workflow from a plain-English description. Dispatches to the create-workflow builder. Run `smithers init` first if the .smithers/ pack is not yet installed. Run `smithers make-workflow --help` for usage details.

smithers-memory

View and query cross-run memory facts. Run `smithers memory --help` for usage details.

smithers-approve

Approve a paused approval gate. Auto-detects the pending node if only one exists. Run `smithers approve --help` for usage details.

smithers-ask-human

Raise a blocking human-approval request from inside a run and wait for the decision. Use when blocked, uncertain, or about to do something irreversible — never guess. Run `smithers ask-human --help` for usage details.

smithers-ask

Ask a question about Smithers using your installed agent and the Smithers MCP server. Run `smithers ask --help` for usage details.

smithers-bug

File a smithers bug report to bug.smithers.sh; with --run it attaches the run's status, error, and last ~50 events (secrets scrubbed). Run `smithers bug --help` for usage details.

smithers-chat

Show agent chat output for the latest run or a specific run. Run `smithers chat --help` for usage details.

smithers-cron

Manage and run background schedule triggers. Run `smithers cron --help` for usage details.

smithers-deny

Deny a paused approval gate. Run `smithers deny --help` for usage details.

smithers-diff

Print DiffBundle as unified diff. Run `smithers diff --help` for usage details.

smithers-eval

Run a workflow over a JSON/JSONL eval suite and write a regression report. Run `smithers eval --help` for usage details.

smithers-events

Query run event history with filters, grouping, and NDJSON output. Run `smithers events --help` for usage details.

smithers-fork

Create a branched run from a snapshot checkpoint (time travel). Run `smithers fork --help` for usage details.

smithers-gateway

Serve the multi-run Gateway RPC/WS control plane for workspace run state; unlike up --serve, this is not tied to one run. `smithers gateway status|stop` manages the workspace's running singleton. Run `smithers gateway --help` for usage details.

smithers-graph

Render the workflow graph without executing it. Run `smithers graph --help` for usage details.

smithers-gui

Open a directory's workspace in the Smithers UI: starts (or attaches to) the workspace Gateway and opens the MOST RECENT run's workflow UI; pass --workflow <id> to open a specific workflow UI directly. Run `smithers gui --help` for usage details.

smithers-hijack

Hand off the latest resumable agent session or conversation for a run. Run `smithers hijack --help` for usage details.

smithers-human

List and resolve durable human requests. Run `smithers human --help` for usage details.

smithers-logs

Tail the event log of a specific run. Run `smithers logs --help` for usage details.

smithers-migrate

Copy the legacy bun:sqlite smithers.db into PGlite or Postgres and write the migrated.json marker. Run `smithers migrate --help` for usage details.

smithers-monitor

Open the Smithers Monitor: a live web UI over every run in this workspace (runs, execution trees, events, approvals). Starts the workspace Gateway automatically if none is running; pass --no-autostart or --gateway <url> to opt out. Run `smithers monitor --help` for usage details.

smithers-node

Show enriched node details for debugging retries, tool calls, and output. Run `smithers node --help` for usage details.

smithers-openapi

Generate AI SDK tools from OpenAPI specs. Run `smithers openapi --help` for usage details.

smithers-optimize

Run GEPA prompt optimization over a workflow eval suite and write an optimized prompt artifact. Run `smithers optimize --help` for usage details.

smithers-output

Print node output row. Run `smithers output --help` for usage details.

smithers-ps

List active, paused, and recently completed runs. Run `smithers ps --help` for usage details.

smithers-replay

Fork from a checkpoint and resume execution (time travel). Run `smithers replay --help` for usage details.

smithers-restore

Restore a worktree to a durability checkpoint (latest for the node, or --seq). Run `smithers restore --help` for usage details.

smithers-retry-task

Retry a specific task within a run, then resume the workflow. Run `smithers retry-task --help` for usage details.

smithers-revert

Revert the workspace to a previous task attempt's filesystem state. Run `smithers revert --help` for usage details.

smithers-signal

Deliver a durable signal to a run waiting on <Signal> or <WaitForEvent>. Run `smithers signal --help` for usage details.

smithers-starters

Show plain-English starter workflows with copy-paste commands. Run `smithers starters --help` for usage details.

smithers-alerts

List and manage durable alert instances. Run `smithers alerts --help` for usage details.

smithers-cancel

Safely halt agents and terminate a run. Run `smithers cancel --help` for usage details.

smithers-chat-create

Create and start a one-task auto-hijacked chat run. Run `smithers chat-create --help` for usage details.

smithers-docs-full

Print llms-full.txt (full docs bundle for LLMs) for this CLI version. Run `smithers docs-full --help` for usage details.

smithers-docs

Print llms.txt (concise docs index for LLMs) for this CLI version. Run `smithers docs --help` for usage details.

smithers-down

Cancel all active runs. Like 'docker compose down' for workflows. Run `smithers down --help` for usage details.

smithers-hermes

Add Smithers to a local Hermes agent: register the MCP server and install the native Hermes plugin (slash commands, live status line, approval buttons). Alias for `mcp add --agent hermes`. Run `smithers hermes --help` for usage details.

smithers-inspect

Output detailed run state, including steps, agents, approvals, and outputs. Run `smithers inspect --help` for usage details.

smithers-observability

Start the local observability stack (Grafana, Prometheus, Tempo, OTLP Collector) via Docker Compose. Run `smithers observability --help` for usage details.