pcode

pcode is a terminal-native coding agent that lets you change what's visible in your scrollback, even after the work is done. Expand commands, output, and diffs when you need the details; hide them when you want to read the conversation. The same history, with the detail you choose.

Long-running commands continue in the background and wake the agent when they finish. Run sessions in separate git worktrees, or rewind and branch a conversation to try another approach.

• Slow work doesn't block you. Long commands become background jobs, and a finished job wakes the agent, so it can watch tests or CI and fix what fails.
• Agents in parallel. A git worktree per session lets several agents work on one repo at once.
• Rewind and fork. /tree returns to any point in a conversation and branches from there. Every session is kept, so you can resume or search it.
• Change your view, not your history. Show or hide commands, output, and diffs throughout the conversation. Hidden output stays available, and /tools lets you inspect every tool call and its full output.

It runs on any model Pydantic AI supports, or on your Claude or ChatGPT subscription.

Documentation: cruxwell.github.io/pcode

Install

With Homebrew:

brew tap cruxwell/pcode https://github.com/cruxwell/pcode.git
brew install cruxwell/pcode/pcode

Or from PyPI with uv:

uv tool install 'pcode[claude]'

brew install --HEAD tracks master instead of the latest release.

Quick start

pcode -m claude:claude-sonnet-5              # Claude subscription; run /login claude if not signed in
pcode -m openai-codex:gpt-5.6-luna           # ChatGPT subscription (/login openai-codex)
pcode -m anthropic:claude-sonnet-5           # or any provider, with its API key set
pcode                                        # reuses the model /model (Ctrl+L) saved; with none, an offline preview
pcode -C /path/to/repo "Summarize the open TODOs"
git diff | pcode -p --no-save                # non-interactive: reply to stdout
pcode --continue                             # resume this directory's newest session
pcode --theme-preview                        # offline sample output and the style gallery

The agent edits files and runs shell commands with your permissions and no approval prompt. Read tool permissions before pointing it at anything you care about.

More

• Your subscription: Claude runs through Anthropic's own Agent SDK and Claude Code login (the route Anthropic supports), and ChatGPT through a Codex login. See providers.
• Email remote control: send a task from Gmail on your phone, reply to keep going, and take the session over at a terminal with pcode --attach.
• Custom keybindings and Vim editing: map keys to commands with arguments, add a Space leader in normal mode, or use jj to leave insert mode.
• /btw side questions, background sessions, recall of past sessions, a browser the agent can drive, and Python extensions.
• Built on Pydantic AI's Harness coder, with MCP (OAuth and tool search), searchable sessions, jobs and worktrees on top. Extensions are plain Pydantic AI capabilities. The conversation tree follows pi's.

See PLAN.md for the longer-term direction.

Documentation

The same pages build into a browsable site with make docs-serve; make docs checks every page and anchor link.

Contributing

Bugs: open an issue. Security problems: see SECURITY.md. Setup and checks are in CONTRIBUTING.md.

make test        # fast suite; real-tmux regressions skipped
make test-all    # everything, before touching layout, streaming, the editor, or the prompt

AGENTS.md has the worktree workflow and the traps worth knowing before editing. Contributor notes (architecture, dependencies, profiling, prompt caching, provider design) live in dev/, outside the published docs.