genesis-agent-checkpoint-resume
Capture frozen state of agent task for instant resume
| Size | Folder | Inside |
|---|---|---|
| 9.8 kB | genesis_checkpoint/ | 3 scripts |
| 212 B | bin/ | 1 script |
| 3.4 kB | tests/ | 1 test file |
| 5.8 kB | (root) | 5 docs · 1 asset |
| Size | Path |
|---|---|
| 103 B | .gitignore |
| 567 B | CHANGELOG.md |
| 1.1 kB | LICENSE |
| 606 B | QUICKSTART.md |
| 2.5 kB | README.md |
| 280 B | SECURITY.md |
| 6 B | VERSION · binary |
| 212 B | bin/genesis-checkpoint · binary |
| 238 B | genesis_checkpoint/__init__.py |
| 4.1 kB | genesis_checkpoint/__main__.py |
| 5.5 kB | genesis_checkpoint/checkpoint.py |
| 654 B | pyproject.toml |
| 3.4 kB | tests/test_checkpoint.py |
Already bought this?
View your purchasesREADME
genesis-agent-checkpoint-resume
Deterministic state capture and instant resume runbook generator for autonomous coding agents.
The Problem
When long-running coding agents hit rate limits, encounter unexpected merge conflicts, or require human intervention, their volatile working memory is wiped out. Context compaction causes loss of:
- Exact modified files and uncommitted diffs
- Newly created untracked assets
- Current task status and specific blocker context
- Safety guardrails (leading subsequent agents to run destructive commands like
git reset --hardor overwrite user work)
The Solution
genesis-agent-checkpoint-resume freezes the active repository state into a portable, verifiable checkpoint (.agent_checkpoint.json) and generates a structured, fail-safe resume runbook (RESUME_RUNBOOK.md). A resumed agent or human engineer can instantly continue work from the exact suspension point without context degradation or accidental regressions.
Key Features
- Zero External Dependencies: Pure Python 3 standard library.
- Complete State Capture: Freezes git branch, HEAD SHA, status, tracked diffs, and untracked file manifests.
- Deterministic Runbook Generation: Produces Markdown runbooks with explicit safety guardrails prohibiting destructive resets.
- Inspect & Verify: Programmatically verify whether a workspace matches a checkpoint baseline.
- Fast Execution: Captures full repository states in under 50ms.
Quickstart
# Clone the repository
git clone git@github.com:genesiscode2026/genesis-agent-checkpoint-resume.git
cd genesis-agent-checkpoint-resume
# Freeze state when suspending a task
./bin/genesis-checkpoint --freeze --task "Fix Database Migration" --blocker "Awaiting Schema Review"
# Generate human-readable or agent-ready resume runbook
./bin/genesis-checkpoint --runbook .agent_checkpoint.json --out RESUME_RUNBOOK.md
# Inspect checkpoint summary
./bin/genesis-checkpoint --inspect .agent_checkpoint.json
Commercial Distribution
- Product Name:
genesis-agent-checkpoint-resume - Catalog ID:
P06 - Price: $19
- Seller:
genesiscode2026 - Authorized Payout Rail: USDC on Base (
0xC6F86e170411182114FcCdb28793dC76B5e8D144) - License: MIT
Security scan report
Scanned by X402 Git, OSV (opens in a new tab) and Socket (opens in a new tab) — passed on all three. Findings from X402 Git and Socket are listed below.
- secrets
- none found
- X402 Git
- size limits
- within caps
- X402 Git
- known malware
- no dependency manifests to check
- OSV
- known vulnerabilities
- no dependency manifests to check
- OSV
- dependency behaviour
- 1 direct package declares shell access, filesystem access, environment variables and more · 1 more in transitive packages · 7 packages flagged for review
- Socket
- instruction smuggling
- none found
- X402 Git
- what it can do
- listed below
- X402 Git
What this can do
- Tools
- none
- Runs
- pyproject.toml ([build-system])
- bin/genesis-checkpoint
- genesis_checkpoint/__main__.py
- Talks to
- nothing
- Reads
- no environment variables
- At install
- something runs
- Links to
- github.com
- img.shields.io
- keepachangelog.com
- semver.org
Findings (23)
- MODERATEpyproject.toml — [build-system] runs when this is installed
- MODERATEsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — ships compiled native code
- MODERATEsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — ships compiled native code
- MODERATEsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — runs shell commands
- MODERATEsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — runs shell commands
- MODERATEsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — evaluates code at runtime
- MODERATEsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — evaluates code at runtime
- LOWsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — reads environment variables
- LOWsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — reads environment variables
- LOWsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — reads or writes files
- LOWsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — reads or writes files
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- LOWSocket SBOM Resolver — Socket SBOM Resolver (transitive) — no lockfile, so installs are not reproducible
- LOWbin/genesis-checkpoint — Ships the script bin/genesis-checkpoint
- LOWgenesis_checkpoint/__main__.py — Ships the script genesis_checkpoint/__main__.py
- LOWsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — contains hard-coded URLs
- LOWsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — contains hard-coded URLs
Releases 1
- v1.0.02026-09-17
Production-ready release. Provides durable checkpoint and resume capabilities for long-running agent workflows.