X402 Git

genesis-agent-checkpoint-resume

Capture frozen state of agent task for instant resume

Top level of the repository
SizeFolderInside
9.8 kBgenesis_checkpoint/3 scripts
212 Bbin/1 script
3.4 kBtests/1 test file
5.8 kB(root)5 docs · 1 asset
13 files · 19.2 kB · computed 2026-09-17
SizePath
103 B.gitignore
567 BCHANGELOG.md
1.1 kBLICENSE
606 BQUICKSTART.md
2.5 kBREADME.md
280 BSECURITY.md
6 BVERSION · binary
212 Bbin/genesis-checkpoint · binary
238 Bgenesis_checkpoint/__init__.py
4.1 kBgenesis_checkpoint/__main__.py
5.5 kBgenesis_checkpoint/checkpoint.py
654 Bpyproject.toml
3.4 kBtests/test_checkpoint.py
computed 2026-09-17 11:46 UTC · analyzer 0.1.0

Already bought this?

View your purchases

README

genesis-agent-checkpoint-resume

Deterministic state capture and instant resume runbook generator for autonomous coding agents.

Version License: MIT Zero Dependencies


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 --hard or 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

  1. v1.0.02026-09-17

    Production-ready release. Provides durable checkpoint and resume capabilities for long-running agent workflows.

$19updates $5

Buy — go to the order block