Turnback MCP server

Turnback

Undo for AI coding agents, even after rm -rf.

One undo history for Claude Code, Codex, Cursor, Gemini CLI, OpenCode, and Antigravity CLI.

A real Turnback run. The agent is simulated with Claude Code's hook payloads; the rm -rf and every Turnback line are real. Recreate it with python scripts/demo/make_demo.py.

Why

Agent checkpoints track the agent's own edit tools. Claude Code's documentation says it plainly: "Checkpointing does not track files modified by Bash commands." So when an agent runs rm -rf, mv, a code generator, or git checkout -- ., rewind cannot bring those files back.

Turnback snapshots the workspace before every shell command and edit, into a shadow git repo under ~/.turnback:

• Undo a whole turn, or go back to just before one step of it.
• Tracked, untracked, and gitignored files (like .env) up to 5 MB are covered.
• Nothing writes to your project's .git unless you run turnback export --commit, and hooks never block the agent.
• One history across six agents. Through MCP, the agent can list and diff its own turns and restore them in two steps: a plan first, then the change.

Install

In Claude Code:

claude plugin marketplace add MFaizR77/turnback
claude plugin install turnback@turnback

Then use /turnback:turns, /turnback:diff-turn, /turnback:undo, and /turnback:report.

For Codex, Cursor, Gemini CLI, OpenCode, Antigravity CLI, or the CLI on its own (Node.js 22+ and Git 2.25+):

npm install -g turnback
turnback install all            # user-level hooks and MCP for every agent
turnback install codex --project  # or one agent, in this project only

Claude Code, Codex, OpenCode, and Antigravity CLI have been tested live; Gemini CLI and Cursor are covered by tests built from their documented hook payloads. Details per agent: installation.

Compared with Claude Code's /rewind

They work side by side: rewind the conversation with /rewind, and the files with Turnback.

Everyday use

turnback list                       # recent turns with their prompts
turnback diff <turn>                # what a turn changed
turnback undo --dry-run             # show the plan
turnback undo --yes                 # undo the latest turn
turnback redo --yes                 # changed your mind
turnback steps <turn>               # each edit and shell command in a turn
turnback restore <turn> --before-step 3 --yes
turnback mark "before migration"    # a checkpoint of your own
turnback run -- npm run codegen     # any command as an undoable turn, no agent needed
turnback recover src/app.ts         # bring back one file an agent deleted turns ago
turnback blame src/auth.ts          # which turn and prompt wrote each line
turnback ui                         # timeline in the browser

Without an agent

turnback run records any command as a turn, so a code generator, a codemod, or an agent without hooks gets the same undo. blame shows which turn wrote each line, and recover brings back a single file:

Shortened. The full README is on GitHub.