Undo for AI coding agents, even after rm -rf.
One undo history for Claude Code, Codex, Cursor, Gemini CLI, OpenCode, and Antigravity CLI.

Усильте агента
Собственная команда издателя. Не эндпоинт PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]У Claude Code нет ссылки для установки локальной команды. Скопируйте команду ниже и выполните её в терминале.
claude mcp add io.github.mfaizr77-turnback -- npx -y turnback@0.9.1Выполните в терминале.
{ "mcpServers": { "io.github.mfaizr77-turnback": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
Удалённый URL или команда на вашем компьютере? Чем различаются два способа установки
Запустить на PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
Запуск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.
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:
.env) up to 5 MB are covered..git unless you run turnback export --commit, and hooks never block the agent.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.
In Codex (available in the next npm release):
codex plugin marketplace add MFaizR77/turnback
codex plugin add turnback@turnback
Start a new session, review and trust Turnback's hooks in /hooks, then use $turnback:turns, $turnback:diff-turn, $turnback:undo, and $turnback:report.
The plugin needs Turnback 0.9.1 or later. To try unreleased plugin changes from a checkout, see local testing.
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.
/rewindThey work side by side: rewind the conversation with /rewind, and the files with Turnback.
turnback --help # commands, options, and quick-start examples
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 (or a folder) an agent deleted turns ago
turnback blame src/auth.ts # which turn and prompt wrote each line
turnback report --pr --apply # add which prompts wrote this branch to its pull request
turnback du # Turnback's disk use for every workspace
turnback ui # timeline in the browser
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:

All commands, including log, search, report, compare, and export: commands. More: restore, MCP, scope and limits.
The hook before a mutating tool takes the turn baseline. The hook before a shell command captures the whole tree; later edits capture the affected paths. The end of the turn captures the result. The initial snapshot is warmed in the background on install and session start. Hooks always let the agent continue when recording fails; a failed, skipped, or unprotected state is visible through status.
Tracked, untracked, and gitignored files up to 5 MB are covered. Build output and dependency directories are excluded. Extra rules use gitignore syntax in .turnbackignore; global rules go in ~/.turnback/config.json as {"exclude":["pattern"]}.
Workspaces above 100k files or 2 GB switch to edits-only mode: only paths touched by edit tools are snapshotted, shell commands are recorded as unprotected, and restore touches only recorded paths. Turns older than 7 days and outside the last 50 turns are cleaned up automatically, at most once a day, in every workspace and not only the one in use. Data of a workspace that was deleted is removed after 30 idle days; set {"autoClean": false} in ~/.turnback/config.json to keep it.
Issues labeled good first issue are small and say which files they touch, and support for more agents is welcome. Start with CONTRIBUTING.md and the architecture overview. Questions and ideas go to Discussions.
Every merged pull request is credited in the release notes.
npm run check
npm run bench
The benchmark creates a temporary 10k-file repo and reports latency without making it a strict CI gate. CI runs the tests and benchmark on Windows, macOS, and Linux × Node 22/24.
From a clone, run npm ci && npm run build and use node dist/cli.js in place of turnback.
Set the same version in package.json and in both version fields of server.json, commit, then push a v<version> tag. The Publish workflow checks that the versions match, runs the tests, publishes to npm through trusted publishing (provenance is attached automatically), and publishes server.json to the MCP registry as io.github.MFaizR77/turnback.
Also update src/core/config.ts, both plugin manifests, and the npm ranges in .claude-plugin/marketplace.json and .agents/plugins/marketplace.json.
npm trusted publishing is configured on the package page at npmjs.com (repository MFaizR77/turnback, workflow publish.yml), which needs the package to exist. The first version is therefore published once by hand with npm publish --access public; pushing its tag afterwards skips npm (the version exists) and only publishes to the MCP registry. Later tags do both.
MIT
Undo a coding agent turn, including shell commands and untracked files.
{ "mcpServers": { "io.github.mfaizr77-turnback": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Инструменты
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
FAQ
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
В этой записи не указано обязательных переменных окружения.
Turnback работает локально через stdio.
Последняя проверка: 2026-11-09. Undo a coding agent turn, including shell commands and untracked files.