Open source · AGPL-3.0

A web workspace for your Pi coding agents.

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.

Pico workspace where an agent runs two subagents, each in its own worktree

What Pico does

Durable agents

All agents live in one SQLite database. Turns continue after a crash or restart. Tools with side effects do not run twice.

A full workspace

See Git changes and diffs, browse files with syntax highlighting, and open terminals next to the agent.

Rich agent tools

Todo lists, questions, background jobs, terminals, subagents in Git worktrees, browser automation, web access, and MCP.

Tool profiles

Pick full, builder, researcher, reviewer, or read-only, or make your own. Subagents get a profile from their parent and a bash guard.

Many machines

Add other computers over SSH or Tailscale. Their agents show in the same sidebar and keep running on their own machine.

Search past work

Find any message of any agent, also on other machines. Agents can search past work too.

Scripts and the command line

Start, message, and wait for agents with pico-app agent. Exit codes tell a script if the agent is done, failed, or needs you.

An MCP server

Claude Code, Codex, and other MCP clients can start, message, search, and wait for Pico agents.

Works with Pi

Pico uses your Pi skills, prompt templates, project instructions, and credentials.

See it work

One agent starts two subagents, each in its own Git worktree. When both are done, it merges their branches and runs the tests.

On your phone, too

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.

Pico on a phone in dark mode Pico on a phone in light mode

Get started

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.