A browser workspace for the pi coding agent. Hand work to subagents you can follow, and read every change as steps before it lands.
curl -fsSL https://raw.githubusercontent.com/Naomarik/sova/master/scripts/install.sh | bashThen run sova, and sova open. Needs Git and Node.js ≥22.19.
Sova is one web app at every width: pair your phone once by scanning a one-use QR code, install it to the Home Screen, and a session that needs you reaches your lock screen. Folded or open, the same session follows you.
For people who already run coding agents. Your pi sessions, logins, and extensions come with you.
In Delegate, a session's agent becomes an orchestrator: it sends each kind of work to the model you routed it to. Every worker opens in the side pane with its own transcript.
The shipped routes use Claude Code models, so install the claude CLI or pick your own in Settings → Subagents.
With align on, the agent works out what to build with you first, and records the approach, the alternatives it rejected, and its open questions, each with a recommendation. Answer with just “1a”.
Ask what changed and the agent lays it out as numbered steps, each with a line on why, and no hunk left out. A session also keeps track of the git worktrees it works in.
The changes viewer only reads, and Sova never removes a worktree on its own.
The Needs you list shows every session waiting on you: a question, an error, a failed worker. The Overseer, a session that reads all the others, can tell you what needs you, start sessions, or send them prompts.
The list costs no tokens. The Overseer has no shell and edits no files.
Pair once by scanning a one-use QR code, then answer a question, steer a turn, or start a session. With notifications on, a session that needs you reaches your lock screen.
Sova listens on 127.0.0.1. For a phone to reach it, use tailscale serve or your own HTTPS proxy. On iPhone, add Sova to the Home Screen for notifications.
Rewind to before any message you sent, regenerate or fork from a reply, steer a running turn without stopping it, or switch models mid-session. The context you built stays.
Use Claude Code's models in chat and in workers, across several logins. A session or worker that hits a usage limit moves on to the next one.
Needs the claude CLI installed and logged in.
On runs a session's bash in an OS sandbox and checks file tools against the same policy. The default keeps a worker in a worktree writing only there.
It contains an agent's mistakes, not hostile code, and it hasn't been audited.
Markdown recipes an agent runs against a project, picked from the composer or run on a schedule. Sova ships 5.
A schedule fires only after you approve it.
A read-only link to a session or part of it, as a snapshot or live. You see who opened each one.
Needs an address you set up (how). Recipients need no account.
Voice input, tools on your SSH or Docker targets, usage and load pages, and model rules.
Each needs setup beyond the install.
Run Sova on several machines on your tailnet and use them all from one page.
Needs Tailscale, and the same Sova build on every host.
Hand one conversation from person to person, each through their own link, and keep every decision with who made it.
People outside your tailnet need a listener behind your own HTTPS proxy.
Pick one in Settings → Themes, or save your own in ~/.pi/agent/sova/themes/. No rebuild, no restart.
// ~/.pi/agent/sova/themes/desk-lamp.json { "name": "Desk Lamp", "extends": "dark", "vars": { "amber": "#ffb454" }, "colors": { "accent": "$amber", "accent-tint": "#3a2f1c" } }
A server with the pi coding agent embedded, plus a web app. It uses pi's own agent directory: your sessions, logins, and extensions.
The desktop workspace, or the folded layout installed on a phone.
Hono and the pi SDK, on 127.0.0.1:4800 by default.
pi's agent directory. Sova's own state lives in sova/.
Optional. A session it has open streams into Sova live, and stays read-only there.
~/.local/share/sova and a ~/.local/bin/sova launcher. No sudo, no system packages, no shell-profile edits, no settings.~/.pi/agent/extensions/. --no-extensions skips this.--service.~/.pi/agent/sova/auth-token and restart to sign every browser out.Sessions you already have show up as soon as it starts.
curl -fsSL https://raw.githubusercontent.com/Naomarik/sova/master/scripts/install.sh | bashThen run sova, and sova open.
TypeScript end to end: a SolidJS web app and a Hono server with the pi SDK embedded. Read the code, file an issue, or run a checkout.
# Run a checkout: Git, Node.js ≥22.19, pnpm, and Bun 1.4.2 git clone https://github.com/Naomarik/sova.git cd sova pnpm install --frozen-lockfile pnpm run build pnpm start # http://127.0.0.1:4800, on Bun pnpm start --node # the same, on Node