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
Pico 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
pico-app 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 Pico agents.
Pico 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.
Pico works well on small screens. Connect over Tailscale and check on your agents from anywhere.
Pico 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 Pico from npm:
npm install -g @alivault/pico
pico-app
Pico starts and opens http://127.0.0.1:3141 in your
browser. Add provider credentials in Pico, or use the ones in
~/.pi/agent/auth.json.
To try it without a global install:
npx @alivault/pico
Useful commands:
pico-app status # is Pico running?
pico-app stop --wait # stop after active turns finish
pico-app import-pi # import Pi sessions as agents (stop Pico first)
pico-app machine add ali@workbox # show the agents of another computer
pico-app agent start . "Fix the flaky test" --wait # run an agent from a script
pico-app agent search "websocket" # search the messages of all agents
pico-app mcp # add Pico to Claude Code or Codex
pico-app --help
Your data is in ~/.pico. To build from source, see the
README.