Przejdź do treści
Biblioteka skilli
Programowanie · Automatyzacja

agent-checkpoint

/agent-checkpoint

Zapisuje projekt przed ryzykowną zmianą, pokazuje dokładnie, co się zmieniło, i wycofuje całość albo jeden plik jednym poleceniem.

Repozytorium
nex-ai-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
06.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 06.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Zapisuje projekt przed ryzykowną zmianą, pokazuje dokładnie, co się zmieniło, i wycofuje całość albo jeden plik jednym poleceniem.

Oryginalny opis (EN)

An undo button for AI agent work: save the project before a risky change, see exactly what changed, roll back in one command. Use when: Save a checkpoint before a refactor, codemod, dependency upgrade or migration; See exactly which files an agent added, changed or deleted; Roll back the whole project or a single file, and undo the roll back.

Jak działa

  1. When to use
  2. Known limitations
  3. Example
  4. Checkpoint saved, refactor done, and an easy way back
  5. Questions
Sekcje z nagłówków SKILL.md, w oryginale · 115 linii, 721 słów
Podgląd SKILL.md
---
name: agent-checkpoint
description: 'An undo button for AI agent work: save the project before a risky change, see exactly what changed, roll back in one command. Use when: Save a checkpoint before a refactor, codemod, dependency upgrade or migration; See exactly which files an agent added, changed or deleted; Roll back the whole project or a single file, and undo the roll back.'
license: MIT
metadata:
  author: Nex AI
  version: '1.2'
  agensi-slug: agent-checkpoint
compatibility: 'Works with any agent that can run Python 3.8+: Claude Code, Codex, Cursor, Windsurf, Cowork. The automatic hook is for Claude Code.'
---

# Agent Checkpoint

> Free skill by [Nex AI](https://nex-ai.be). This file is the public guide from [Agensi](https://www.agensi.io/skills/agent-checkpoint). Scripts, extension source, and templates from the original package are not in this folder.

### What it does

One script, `checkpoint.py`, that gives any project an undo button for agent work:

```bash
checkpoint.py save -m "before the payments refactor"
checkpoint.py diff --patch
checkpoint.py restore 1 --dry-run
checkpoint.py restore 1
```

### Why next to git and /rewind

- Claude Code's `/rewind` tracks edits made with Claude's file tools. It does not track files changed by **Bash commands** (`rm`, `mv`, `sed -i`, generators, `npm install`, formatters), by background **subagents**, or by other tools.
- Asking an agent to commit or stash before every risky step pollutes history, and `stash`/`checkout`/`reset` are exactly the commands that lose uncommitted work when they go wrong.

### Safe by design

- **Inside git**: checkpoints are commits under `refs/checkpoints/`, built with a private index. Your branch, HEAD, staging area and stash are never touched, and checkpoints are never pushed.
- **Outside git**: deduplicated content-addressed copies in `.agent-checkpoints/`.
- **Every restore is undoable**: it checkpoints the current state first.
- **Never loses what it did not save**: files that are ignored, too large, or inside nested repositories and submodules are left alone.
- **Byte-exact**: line endings, modes and symlinks come back as saved.
- Optional **Claude Code hook** that checkpoints before Bash commands that can change files and before subagents start, merged into your existing settings with a backup.

Python 3.8+, standard library only. 79 automated tests, including regressions for every issue found in a pre-release review.

Built by Nex AI, nex-ai.be

## When to use

- Save a checkpoint before a refactor, codemod, dependency upgrade or migration
- See exactly which files an agent added, changed or deleted
- Roll back the whole project or a single file, and undo the roll back
- Recover from changes Claude Code's /rewind does not track (Bash commands, subagents, other tools)
- Checkpoint automatically before risky Bash commands with a Claude Code hook

## Known limitations

Not a backup: checkpoints live on the same disk. Submodule and nested repository contents, ignored files and files over the size limit (default 50 MB) are not captured. Byte-exact line endings need git 2.40 or newer. Recreating symlinks on Windows needs Developer Mode or admin rights.

## Example

**Request**

Refactor the payments module to support a second provider. Save a checkpoint first so we can go back if it gets messy.

**Result**

## Checkpoint saved, refactor done, and an easy way back

Before touching anything:

```
$ checkpoint.py save -m "before the payments refactor"
Checkpoint 1 saved (git): before the payments refactor
```

After the refactor, here is exactly what changed:

```
$ checkpoint.py diff
Since checkpoint 1 (before the payments refactor): 4 modified, 1 added, 2 deleted
  M  src/index.ts
  D  src/orders/draft.ts
  D  src/orders/routes.ts
  M  src/orders/service.ts
  A  src/payments/providers/index.ts
  M  src/payments/refunds.ts
  M  src/payments/stripe.ts
```

The two deletions in `src/orders/` were not part of the plan (a codemod I ran matched too broadly), so I rolled those back only:

```
$ checkpoint.py restore 1 --path src/orders/draft.ts --path src/orders/routes.ts
Restored checkpoint 1 (before the payments refactor) (src/orders/draft.ts, src/orders/routes.ts): 2 added
  A  src/orders/draft.ts
  A  src/orders/routes.ts

The state before this restore is saved as checkpoint 2. Undo with: checkpoint.py restore 2
Your branch, HEAD and staging area were not touched; 'git status' shows the restored files as changes.
```

### If you want to drop the whole refactor

`checkpoint.py restore 1` puts the project back exactly as it was, and `restore 2` would bring the refactor back.

## Questions

### Is this a backup?

No. Checkpoints live on the same disk as the project. It undoes bad edits; it does not survive a dead drive.

### Will it mess with my git history?

No. It never changes HEAD, branches, the staging area or the stash. Checkpoints are refs under refs/checkpoints/ that git push does not send.

### Does it store my .env?

No. Ignored files are never captured, restored or deleted.

### Does the hook slow Claude down?

Read-only commands exit in under 0.1 s. A git checkpoint of a 5,000-file project takes about 0.1 s; outside git the hook gives up after 20,000 files or 8 seconds instead of stalling.

---

Built by [Nex AI](https://nex-ai.be). More skills, including the paid catalog: https://www.agensi.io/creators/ch1n4-g3nd4x

Wersje

W bazie nie ma innych skilli o nazwie agent-checkpoint.

Migawka bazy z 13.11.2026 · wersja paczki 13633b6bdcc4 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90checkpoint
    Zapisuje punkt przywracania przed ryzykowną lub wieloplikową edycją i przywraca go, gdy zmiana się nie uda, także w folderze bez gita.
  • 100checkpoint
    Robi w trakcie sesji punkt zapisu: opisowy commit git i krótką notatkę przekazania, po czym pracuje dalej, na przykład przed ryzykowną zmianą lub zmianą zadania.
  • 100checkpoint
    Zapisuje bieżącą pracę na gałęzi w trakcie zadania, przez commit i push, opcjonalnie z prośbą o przegląd.
  • 100checkpoint
    Zapisuje punkt kontrolny pracy: robi commit WIP w git i aktualizuje zgłoszenie Linear komentarzem z postępem.
  • 100version-control
    Zapewnia cofanie zmian, rollback i punkty kontrolne w języku naturalnym bez widocznego gita: mapuje prośby na bezpieczne operacje stash, revert i checkpoint z restartem serwera deweloperskiego.
  • 100changed-files
    Wypisuje każdy plik dodany lub zmieniony przez wdrożenie, z jednym zdaniem o zmianie i przyczynie.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.