Back to projects
betav1.2.2

PatchPilot

A coding agent that shows its work — every read, command, and token, in your terminal.

PatchPilot runs coding-agent tasks inside your repo and keeps the whole run in the open: the transcript, the diff it wants to write, the command it wants to run, the model it's routing to, and what the tokens cost. Risky actions wait behind an approval box. Local Ollama by default — Gemini, OpenRouter, NVIDIA, and Codex when you want them.

Problem

Most coding agents hide the run behind a chat bubble: you can't see which files it touched, what command it's about to run, which model answered, or what it cost — so you can't trust it on a real repo.

What I built

An Ink terminal UI with sticky approval prompts, a live transcript, per-tool permissions, a workspace boundary that blocks secret files, and one setup flow across local and cloud models.

Result

Every powerful action stays reviewable: you see each read, write, and command before it runs, and the diff before you commit.

Audience

For developers who don't trust a chat box that edits their code out of sight.

Latest release

v1.2.2

Developer setup

install CLI with npmnpm install -g @jx-grxf/patchpilot
update CLI with npmnpm update -g @jx-grxf/patchpilot
source without GitHub CLIgit clone https://github.com/jx-grxf/PatchPilot.git && cd PatchPilot
source with GitHub CLIgh repo clone jx-grxf/PatchPilot && cd PatchPilot
latest releaseopen https://github.com/jx-grxf/PatchPilot/releases/tag/v1.2.2
download stable archive with GitHub CLIgh release download v1.2.2 -R jx-grxf/PatchPilot -p 'jx-grxf-patchpilot-1.2.2.tgz'

Highlights

  • Local-first: runs on your own Ollama by default; Gemini, OpenRouter, NVIDIA, and Codex are one switch away.
  • Every file read, proposed write, and shell command lands in the transcript before it runs.
  • Risky actions sit behind a sticky approval box; secret files like .env are blocked outright.
  • Live token, cache-hit, latency, and cost telemetry — including what a free route would have cost on the paid API.