{ "markdown": "

\n \"VibeRevert\n

\n\n

VibeRevert

\n\n

Protect the project you're actually working on.

\n\n

Record · Check · Fix · Restore.

\n\nVibeRevert is the project-integrity layer for AI coding. It records the real working state before an agent starts, flags risky changes with deterministic rules, and lets you remove the agent work you don't want without giving up the rest.\n\n**An agent changed 80 files. 75 are useful. Remove the 5 you don't.**\n\n**No AI judges the AI:** risk findings are reproducible, explainable, and based on rules you can inspect.\n\n**The working state you already had is part of the project.** Staged work, unstaged edits and pre-existing untracked files are recorded before the session starts and preserved through recovery. You don't have to package your work into commits before letting an agent help with it.\n\n**Keep using your coding agent.** VibeRevert works alongside Claude Code, Cursor, and other coding-agent workflows. Git worktrees give an agent an isolated checkout; VibeRevert protects and selectively recovers the working state an agent actually changes. They solve different problems and can be used together.\n\n*AI broke your project? Undo the session, not your week.* Whole-session rollback is still one command.\n\n

\n \n \"npm\n \n \n \"CI\"\n \n \"Node\n \n \"Apache-2.0\"\n \n

\n\n## See it work\n\n

\n \"How\n

\n\nThe actual CLI, condensed from a real beta payment run — `check` flags it, and `rollback` previews what it will change before you `--apply`:\n\n```text\n$ viberevert check\nrisk: CRITICAL · payments\n app/api/checkout/route.ts payments (critical)\n app/api/webhooks/stripe/route.ts payments (critical)\n\n$ viberevert rollback # preview — nothing changed yet\n package.json tracked_restored\n app/page.tsx tracked_restored\n app/api/checkout/route.ts untracked_deleted\n app/api/webhooks/stripe/route.ts untracked_deleted\n lib/stripe.ts untracked_deleted\n .gitignore README.md (your uncommitted work) skipped_unchanged\n```\n\n## Proof, not promises\n\n**3 real AI coding sessions. 3 exact project-file restorations.** Payments, database migrations, and deployment infrastructure — all with pre-existing uncommitted work preserved. [Read the beta report →](docs/beta-report.md)\n\n## Quickstart\n\nWorks inside a Git repository and requires Node.js 22+. VibeRevert keeps its records on your machine and requires no VibeRevert account or hosted service.\n\n```bash\nnpm install -g viberevert@beta\n```\n\n```bash\nviberevert init # one-time setup in your project\nviberevert run # records the session and saves your files' starting state\nviberevert check # see what changed and what looks risky\nviberevert rollback # preview putting your files back; add --apply to restore\n```\n\nRestoring only part of a session works the same way, with a selector:\n\n```bash\nviberevert rollback --only 'app/api/**' # preview just that part\nviberevert rollback --only 'app/api/**' --apply # restore just that part\n```\n\n## What it protects you from\n\nYou let an AI agent work across your project, and it touched more than you expected — maybe payment code, a database migration, a deploy file — while your own half-finished work was sitting right there uncommitted. VibeRevert captures your project's starting file state first, so a session you don't like doesn't cost you your afternoon.\n\n## What VibeRevert does\n\nAround each AI coding session, VibeRevert:\n\n- **Checkpoints your project first** — working tree, staged changes, and untracked files, including work you haven't committed.\n- **Records the session** and the project files that changed while it ran.\n- **Flags risky edits** — changes touching auth, payments, databases, secrets, dependencies, or infrastructure ([risk taxonomy](docs/risk-taxonomy.md)).\n- **Writes an agent-ready fix prompt** from those findings, to paste into your next iteration.\n- **Restores your files** to the checkpoint when you need it.\n\nIt **warns** you; it does not silently block your work. An optional pre-commit hook can reject a commit above your configured risk threshold — opt-in, tunable, and bypassable like any local Git hook.\n\n## Rules decide. Agents fix.\n\nVibeRevert does not ask another language model whether your agent's changes look risky. Its checks are deterministic: the same inputs and configuration produce the same findings, with an inspectable reason for every flag.\n\nWhen something needs attention, VibeRevert can turn those findings into an agent-ready fix prompt. The rules decide what to flag; you decide what happens next.\n\n## Roll back all of it, or only the part that went wrong\n\n`viberevert rollback` restores your **local project files** — tracked, staged, and untracked, including uncommitted work — to how they were when the session started. It previews by default; `--apply` writes the change, and every apply first saves an emergency checkpoint you can recover from.\n\nSince 0.8.0 you can also restore **part** of a session. Say the agent's payments change was wrong but its test additions were fine: put back only the payments work and keep everything else.\n\n```text\n$ viberevert rollback --only 'app/api/**' # preview — nothing changed yet\n[RESTORED] app/api/checkout/route.ts\n[RESTORED] app/api/webhooks/stripe/route.ts\nEligibility: eligible\n\n$ viberevert rollback --only 'app/api/**' --apply\n```\n\nFour ways to choose, and any one of them switches rollback into selective mode:\n\n| Selector | Picks |\n|---|---|\n| `--only ` | changes matching a path pattern |\n| `--except ` | everything but those, subtracted last |\n| `--risk ` | changes a finding rated at or above that level touches |\n| `--finding ` | the changes one specific finding applies to |\n\nPositive selectors combine by intersection, so `--only 'payments/**' --risk critical` means critical changes inside `payments/`, not payments plus every unrelated critical file. Path selectors follow a renamed file, so a file moved out of `payments/` still matches. **Nothing is restored unless everything you selected can be**: if any selected path drifted since the session ended, the whole operation refuses rather than half-applying, and `--force` does not override that. If a selective apply is interrupted, the next one fails closed and points you at the emergency checkpoint rather than layering a second partial restore on top.\n\nTwo current limitations worth knowing before you rely on it:\n\n- **Sessions ended before 0.8.0 cannot be selectively rolled back.** They have no record of what they contributed and it cannot be reconstructed. Whole-session rollback still works on them, unchanged. See [MIGRATIONS.md](MIGRATIONS.md).\n- **`--finding` needs the full finding id**, as printed by `viberevert check --since --json`. Short prefixes are not accepted yet.\n\nIt does **not** reverse effects outside your project files. Deployments, database writes, third-party API calls, payments, and sent emails need their own recovery. Rollback is state-based rather than atomic, and it's a safety net around AI sessions, not a replacement for tests or review. Read [what rollback can and can't restore](docs/rollback-limitations.md) before you rely on it.\n\n## One recovery layer across your coding agents\n\nKeep using the coding tools you prefer. VibeRevert can wrap command-line agent sessions (`viberevert run `) and integrates with tools such as Claude Code and Cursor through its installers.\n\nBuilt-in checkpoints live inside the agent's workflow. **VibeRevert stays with the project.**\n\nIt captures your project's starting state — including uncommitted work — then records the session, flags risky changes, previews the rollback, and keeps that recovery path outside the agent itself.\n\nUse Claude Code today, Cursor tomorrow, or wrap another terminal agent: **the safety layer stays with your project.**\n\n## Wire it into your tools\n\nVibeRevert installs non-destructively and can be removed cleanly. It integrates with Claude Code and Cursor (MCP server and hooks); every install previews its changes and keeps a recovery journal. See [getting started](docs/getting-started.md).\n\nAn **experimental** terminal bridge (`--pty`) can intercept commands inside an interactive agent shell; it's best-effort and documented as such in the [PTY contract](docs/pty-contract.md).\n\n## Platforms\n\nLinux, macOS, and Windows, on Node.js 22+. CI runs the suite across all three on Node 22 and 24; see [compatibility](docs/compatibility.md) for exactly what each platform is tested to do.\n\n## Learn more\n\n- [Getting started](docs/getting-started.md) · [Commands](docs/commands.md) · [Configuration](docs/config.md)\n- [What rollback can and can't restore](docs/rollback-limitations.md) · [Risk taxonomy](docs/risk-taxonomy.md)\n- [Security policy](SECURITY.md) · [Threat model](THREAT_MODEL.md) · [Contributing](CONTRIBUTING.md)\n\n## Support VibeRevert\n\nVibeRevert is Apache-2.0 open source. Sponsoring funds continued cross-platform testing, security work, rollback and recovery testing, and helping pay for independent review. **Sponsorship does not influence risk findings or release decisions.** → **[Sponsor VibeRevert](https://github.com/sponsors/madeinplutofabio?metadata_campaign=viberevert)** · [what your support funds](docs/funding.md)\n\n## License\n\n[Apache-2.0](LICENSE). See [NOTICE](NOTICE) and the [license audit](LICENSE-AUDIT.md).\n", "bytes": 10612, "sha": "ee13b6e4fcd969c99cab204faa3462c348efadb11f2543b92d1751f28289e800", "repo_slug": "madeinplutofabio/vibe-revert", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_com_viberevert_viberevert_a1f1b6f7/readme" }