workflow
Multi-agent workflow (prospector → draftsman → inspector → smith → judge). Collaborative.
REFERENCE
Commands
All commands run inside the pi TUI once the smithy-core extension is registered.
Workflow
The multi-agent pipeline — collaborative, autonomous, or quest-driven.
workflow
Same workflow, fully autonomous — no approval gates. Hard 25-turn ceiling (override with SMITHY_AUTO_MAX_TURNS) — runaway-run backstop, not a token budget.
workflow
Force sequential (no parallel members).
workflow
Cap parallel members at N.
workflow
Exit /plan and launch smith against the approved ledger.
Planning
Plan with prospector/draftsman/inspector; approve, revise, or cancel; /start-work to ship.
planning
Plan-only mode with freeform interview + plan-draft loop (prospector → draftsman → inspector). User approves via [ACTION: approve] freeform marker.
planning
Force-end the interview phase (alias: "done" / "go" / "plan now").
Inspection
Review plans, verify work, and inspect what smithy loaded.
inspection
Force inspector re-review (re-runs the inspector subagent).
inspection
Show the AGENTS.md / CLAUDE.md files smithy loaded for this turn.
inspection
Show the rule files smithy loaded for this session. Pass 'full' to include content.
inspection
Show the last team's full report.
inspection
Show the Claude Code configs smithy loaded for this session. Pass 'full' to include raw content.
inspection
Show loaded Claude Code hooks; pass "on" to enable (env-gated).
Meta
Inspect smithy state: checkpoints, compaction, agents, goals, todos, and the ledger.
meta
Inspect smithy state (model, loops, team runs, sessions).
meta
Show current token/cost usage.
meta
Show bash timeout policy and statistics.
meta
Show compaction config and statistics, or tune: /compaction config toolResultMaxBytes <N>.
meta
Show the current todo list.
meta
Create a git checkpoint now (without waiting for next turn).
meta
List recent git checkpoints in this session.
meta
List available agents (scout, draft, smith, judge, +user-defined).
meta
Re-scan the user and project agents directories.
meta
Show or add/remove user-level allow/deny rules for tools.
meta
Manage per-path tool scopes. Subcommands: list, add, remove.
meta
Manage user goals. Subcommands: list, add, done, cancel, remove.
meta
Show ember state and unfinished todo count, or force-disengage with /ember off.
meta
Pull latest from origin and rebuild if a build script exists (no-op otherwise).
meta
Walk the repo and generate AGENTS.md scaffolding at each directory.
Quest loop
/smithy-quest onlyQuest-only commands used by the autonomous /smithy-quest loop, not the core /smithy workflow. The quest loop runs repeatedly — the parent model orchestrates prospector→draftsman→inspector→smith→judge→questmaster until the questmaster decides the goal is met, a backstop fires, or a user-supplied predicate passes.
Goal-driven autonomous LOOP (model-orchestrated). Repeats prospector→draftsman→inspector→smith→judge→questmaster until the goal is met, --until predicate passes, budget runs out, or --max-iters is hit. Questmaster (a fresh-instance critic) decides QUEST_COMPLETE / QUEST_CONTINUE <next focus> / QUEST_SATURATED between iterations.
Full reference of every smithy slash command registered through
pi.registerCommand
— 34 commands across 5 groups. Click any signature to copy it.
Legacy: /team,
/smithy_loop, and its alias
/ulw are hidden from
/help but still dispatched. Each
emits a one-time deprecation notice recommending
/smithy (collaborative) or
/smithy-auto (autonomous) — but
they don't forward automatically. The deprecation text in
team-mode-tools.ts:703 and
smithy-loop-tools.ts:283 is the
canonical message.
Team-mode parallelism is now spelled out in the slash command itself —
/smithy --concurrency=N caps
parallel members, /smithy --sequential
forces serial. No more aliases to memorize.