prtr edit [files]
Start a focused edit session.
prtr saves your goal, the files you care about, and the current git SHA. It builds a structured prompt, copies it to your clipboard, and opens Claude.
AI Work Session Manager
Start focused. Stay in context. Hand off cleanly.
prtr keeps track of your task goal, the files you care about, your progress notes, and the git diff — and builds the right prompt when you need it. Switch from Claude to Gemini without rebuilding context by hand.
- One session per repo
- Claude, Codex, Gemini handoff
- Git diff built into every prompt
session-workflow.sh
Start → Checkpoint → Hand off → Done.
prtr edit internal/app/app.go
# Claude opens with your goal and context
prtr checkpoint "split help.go done"
prtr @gemini
# Gemini gets the full diff + your note
prtr doneSession workflow
Six commands that keep the AI loop moving
Each command does one thing clearly. Together they take a task from first intent to final handoff without requiring you to paste context by hand at every step.
prtr checkpoint
Save a progress note mid-session.
Each checkpoint records your note and the current git SHA. Checkpoints are included in every handoff prompt so the next AI knows exactly where you stopped.
prtr @gemini
Hand off to another AI model.
prtr computes the git diff since the session started, folds in your last AI response, and builds a handoff prompt with full context — no manual reconstruction needed.
prtr done
Close the session.
Mark the session complete. It stays in your history so you can reference what was accomplished and when.
prtr save
Snapshot your work state (Work Capsule).
Capture the current branch, HEAD SHA, last run, and open todos so you can resume days later — on the same machine or a different one — with drift detection built in.
prtr take --deep
Run the five-worker AI pipeline.
Planner, patcher, critic, tester, and reconciler process the clipboard answer as structured evidence. Writes a plan, diff, risk report, and test plan as local artifacts.
Key concepts
Four ideas that explain how prtr works
prtr is not a prompt template library. It is a session layer that holds your work state and builds the right prompt for each step automatically.
Session
A focused work block tied to a git repo. Stores your goal, files, mode (review/edit/fix/design), base git SHA, and checkpoints. One active session per repo at a time.
Handoff
prtr @gemini or prtr @codex computes the git diff since the session started, adds your last AI response, and delivers a structured context prompt to the next model.
Work Capsule
A full work-state snapshot beyond a single session: branch, HEAD SHA, last run, and open todos. Resume with drift detection after days away or a branch switch.
Multilingual loop
Write your goal in Korean or any language. prtr translates via DeepL, routes to Claude/Codex/Gemini, and protects project terms from being translated away.
Version story
The tool kept moving toward a complete work loop
Each release made prtr a little less like a one-shot prompt helper and a little more like a full session layer that holds context across tools and time.
v1.0.1
Auto response capture
When Claude Code or Codex exits, prtr reads the conversation log automatically. No manual paste needed — the last response is always in the next handoff.
v1.0.0
AI Work Session Manager
Sessions become the primary unit of work. Start with review, edit, fix, or design — checkpoint progress, hand off between models, and resume without rebuilding context.
v0.8.x
Work Capsule and context watching
prtr save and resume snapshot full work state across sessions and tools. Drift detection warns when the branch or HEAD changed since the last save.
v0.7.x
Deep execution pipeline
take --deep runs a five-worker pipeline (planner, patcher, critic, tester, reconciler) and writes structured local artifacts for every run.
v0.3–0.6
Repeatable workflow
go, swap, take, again, learn, and inspect built the reusable command-layer loop that sessions now sit on top of.
Docs hub
Install steps, command guide, and reference in one place
The docs hub has everything you need to go from install to a real first session: platform-specific install instructions, a full usage guide, and a complete command reference.
Included in /docs
Quick start, session guide, Work Capsule reference, deep pipeline docs, and release history
Built as a second page so the homepage stays focused on the product story while the docs page works as the operator-facing entry point.
Start here
Install, verify, and start your first session
Install with Homebrew, run doctor to verify the setup, then start your first session. No API key required for English-only flows — add DeepL later for multilingual routing.
quick-start.sh
brew tap helloprtr/homebrew-tap
brew install prtr
prtr doctor
prtr edit myfile.go