Durable agents
All agents live in one SQLite database. Turns continue after a crash or restart. Tools with side effects do not run twice.
Open source · AGPL-3.0
Smith runs on your machine and keeps every Pi agent safe. Turns continue after a crash or restart. Git, files, terminals, and agent tools are all in one app.
All agents live in one SQLite database. Turns continue after a crash or restart. Tools with side effects do not run twice.
See Git changes and diffs, browse files with syntax highlighting, and open terminals next to the agent.
Todo lists, questions, background jobs, terminals, subagents in Git worktrees, browser automation, web access, and MCP.
Pick full, builder,
researcher, reviewer, or
read-only, or make your own. Subagents get a profile
from their parent and a bash guard.
Add other computers over SSH or Tailscale. Their agents show in the same sidebar and keep running on their own machine.
Find any message of any agent, also on other machines. Agents can search past work too.
Start, message, and wait for agents with
smith agent. Exit codes tell a script if the agent is
done, failed, or needs you.
Claude Code, Codex, and other MCP clients can start, message, search, and wait for Smith agents.
Smith uses your Pi skills, prompt templates, project instructions, and credentials.
One agent starts two subagents, each in its own Git worktree. When both are done, it merges their branches and runs the tests.
Smith works well on small screens. Connect over Tailscale and check on your agents from anywhere.
Smith has no login. Anyone who can reach it can run commands as your user. Keep it on a private network. Never expose it to the public internet.
You need Node.js 22.19 or later and Git. Install Smith from npm:
npm install -g @alivault/smith
smith
Smith starts and opens http://127.0.0.1:3141 in your
browser. Add provider credentials in Smith, or use the ones in
~/.pi/agent/auth.json.
To try it without a global install:
npx @alivault/smith
Useful commands:
smith serve --detach # run in the background
smith status # is Smith running?
smith stop --wait # stop after active turns finish
smith update # install the newest version and restart
smith restart # restart at once; turns continue
smith import-pi # import Pi sessions as agents (stop Smith first)
smith machine add ali@workbox # show the agents of another computer
smith agent start . "Fix the flaky test" --wait # run an agent from a script
smith agent search "websocket" # search the messages of all agents
smith mcp # add Smith to Claude Code or Codex
smith --help
Your data is in ~/.smith. To build from source, see the
README.