Review what your
agent just wrote.
Your coding agent writes the code. Porcelain is the fast, focused viewer built to read and review it: changes ordered the way they flow through your stack, with a two-way loop straight back to your agent.
Apple Silicon · v0.12.0
Agents write the code now. Reading it still means opening a heavy editor.
The bottleneck moved from writing to reading, reviewing, and understanding what the agent produced. For engineers shipping real software, reading it closely is the job.
Cursor, Zed, VS Code are built for authoring: LSP, extensions, refactors. Heavy and slow when you just need to read.
They show diffs as an alphabetical list of files, with no sense of how a change actually flows through the stack.
…talk to your agent. You review in one tool; the agent works in another. Neither knows what the other sees.
A feature, end to end, in the order it runs.
Porcelain reads a whole feature as one narrative: entry point, to hook, to mutation, to schema. Each file carries a note on what it does and what to watch for, so you follow the change instead of reconstructing it in your head.
Changed files, grouped by what they are.
Components, hooks, tests, utils. Porcelain sorts a working-tree diff into the layers of your codebase instead of one flat A-to-Z list, so related changes sit together and you read in passes that make sense.
- ▹ Unified or split diffs, with per-file staging
- ▹ Layers are per-repo, customizable, and agent-managed over MCP
- ▹ Mark files reviewed as you work through them
Stage, commit, and run git, right where you reviewed.
When the read is done, finish the job in place. A commit composer with conventional-commit type and scope chips, suggested next steps, and one-click status, pull, push, fetch and stash. No dropping back to a shell.
- ▹ Conventional-commit type & scope chips
- ▹ Suggested commands from your working-tree state
- ▹ Open review comments stay in view as you commit
Review with your agent,
not just your code.
A bundled one-click Claude Code plugin runs as a local MCP server: it stays on your machine, no telemetry. Your comments become its review context; its work and resolutions flow back to you, on the same feature, in the same order.
Tell the agent exactly what you need.
Select a line or a range, or right-click a whole file, and leave a note: "what should the agent know about this?" Your comments travel to the agent as review context, so it fixes the right thing and marks each one resolved.
- ▹ Comment on a line range or an entire file
- ▹ Notes sync to the agent, resolutions sync back
A kanban the agent reads and updates.
A per-repo To Do / Doing / Done board, connected over MCP. Your agent reads what's planned, moves cards as it works, and writes back what it shipped, all without leaving the same window you review in.
- ▹ One-click Claude Code plugin install, no JSON to paste
- ▹ Local MCP server, nothing leaves your machine
Hide what you'll never touch. Pin what you live in.
Right-click a folder to hide it: it dims out and stops loading. Pin the files and folders you work in to the workspace for one-tap access. Nothing is indexed until you open it, so even huge repos stay instant.
- ▹ Hidden folders dim out and stop loading
- ▹ Pin files or folders to the workspace
- ▹ Nothing loads until you open it, so big repos stay fast
Built to open instantly and stay out of your way.
A complete read-and-review surface.
- Flow-ordered feature view, like a story
- Diffs grouped by layer, custom per repo
- Explore flow: read any feature read-only
- Review comments on lines or files, agent-synced
- "Mark reviewed" with an all-reviewed state
- Working-tree diffs, unified or split
- Commit history, full messages, copy SHA
- Worktree switching; searchable branch picker
- Per-file staging
- Commit composer with conventional-commit chips
- Folder hide / pin for big repos
- Fast viewer with syntax highlighting, images and Markdown
- Split view: two files, drag-resizable
- Quick finder for files, commands, commits
- Repo-wide search; live-refresh on disk change
- One-click Claude Code plugin, no port opened
- Feature review sets, two-way
- Review layers your agent reads & manages
- Project board your agent reads & updates
- Saved actions the agent curates, you run
- Repo notes scratchpad for context
- Real embedded terminal with split panes
- Project board kanban + per-repo notes
- Pinned files for instant access
- Multi-window, one repo per window
- Liquid-glass UI, floating drag-resizable panels
- Auto-updating
- Keyboard shortcuts throughout
Two minutes to your first story.
Download Porcelain
Built for Apple Silicon. Auto-updating: it checks on its own and installs on quit.
Download for macOSNo account. No telemetry. Free forever.
Connect your agent
One click installs the Claude Code plugin: the MCP server and its skills. Or run it by hand:
Then run /reload-plugins. Codex & Cursor coming soon.
Open source, all the way down.
Read every line, build it from source, open an issue, or send a patch. No tracking, no accounts, all local.