GET STARTED
Install
The fastest path: paste one prompt into your pi agent. pi fetches the install guide and does the clone, build, register, restart, and verify for you.
Install with one paste
Install and configure the smithy-agent pi extension by following the guide here:
https://smithy-agent.dev/install-guide.mdPrefer to do it by hand? install-guide.md. Requires Node ≥ 25.
How it works
-
Paste the prompt into your pi agent.
-
pi fetches the install guide.
-
pi clones, builds, registers the extension, restarts, and verifies.
Knowledge base (optional)
smithy-agent runs entirely inside the pi TUI once you've registered
smithy-core. For a
codebase-aware memory (symbol search, code-context retrieval, a code
graph), also register smithy-mcp-bridge
— it spawns the tome MCP server.
Don't add a separate mcpServers.tome
entry; the bridge owns it.
The bridge exposes four tools:
mcp_tome_code_search,
mcp_tome_code_context,
mcp_tome_code_graph, and
mcp_tome_code_hybrid. They
are always listed in the prospector/draftsman/inspector/judge system prompts;
the bridge determines whether the calls succeed or return a connection error.
When the bridge isn't running, the agents fall back to grep/find/ast_grep — no
degradation beyond slower symbol queries.