PiX

A desktop shell on Pi Agent — fork it into yours

PiX is a local coding workbench built on the open-source Pi Agent SDK. Use it as-is, or take the codebase and shape your own agent product.

Core capabilities

Real coding work stays visible, controllable, reviewable, and restorable — all on your machine.

Local project workbench

Open a Git project, confirm Workspace Trust, manage projects and task history; files and commands run locally by default.
Real agent runtime

Built on the Pi Agent SDK — provider login, model switching, thinking levels, streaming replies, tool calls, stop, and follow-up.
Rich context input

Reference project files with @, attach images, and pick standard /skill:name skills with $.
Permissions & audit

The main process classifies tool risk; Ask, auto-reads, and read-only modes, with approvals and auto-decisions logged.
Diff & precise restore

Multi-file diffs, pre-task snapshots, pre-write backups, concurrent-edit detection, and safe per-file or whole-round revert.
Automations

Save prompts and trigger them manually, on an interval, daily, or when a task finishes; each automation has its own approval mode.
Skills

Discover Pi-standard global and project skills with search, scope filters, composer invocation, and installable examples.
Local terminal & search

Workspace-scoped terminal, project file tree, cross-project search, session search, and diagnostics export.

Understand the task → edit code → verify → review the diff → keep or revert.

1

Open a local project

Pick a Git repo on your machine and start a task.
2

Let the agent work

Watch reads, edits, and commands stream in — transparent, not a black box.
3

Review, then decide

Inspect the multi-file diff. Keep the result or revert the whole round safely.

A quick look at the workbench, an agent run, and the local usage dashboard.

Local projects, task history, permission modes, model selection, and context input in one workbench.

Agent run with tool calls, reasoning, completion summary, and the Changes review panel.

Local Usage & Cost: run counts, tokens, spend trends, and model breakdown.

The agent runtime comes from Pi — multi-provider models, tools, and the coding loop — so PiX can focus on the desktop workbench around it.

Pi Agent SDK

Powered by the open-source Pi coding agent. Providers, models, and tool calls ride on Pi instead of a closed proprietary runtime.
Desktop workbench

Chat, approvals, multi-file diffs, checkpoints, and local Git — the UI and process boundaries live in PiX.
Local by default

Open a Git project on your machine. Files, shell, and review stay with you.

PiX is a starting point, not a black box. Fork the repo, swap the branding, tune the workbench, and ship an agent that fits your product.

1

Fork the shell

Electron + React desktop app with typed IPC — keep what you need, cut what you don't.
2

Keep Pi as the engine

The AgentRuntime adapter wraps Pi. You stay on the Pi ecosystem while owning the product surface.
3

Ship your agent

Rename, rebrand, add your workflows — turn PiX into the agent experience you want to offer.

Clone PiX, explore the Pi integration, and build the agent you want on top.

Open the repo