Durable agent handoffs.

Compact one high-entropy session into a dense seed, and let many workers reconcile through git without lost updates. A serializable, provenance-carrying handoff protocol for multi-agent, multi-worktree work.

●Git-serializedtracked state goes through git ◆Flags driftdrift-check exits nonzero ▲Advisory statewarned about, not locked

Why it exists

An agentic session is a conversation, scratch files, several open worktrees and half-formed understanding. Almost none of it survives to the next session. germinate makes the part that keeps sessions durable and mergeable the part you carry forward.

Install

npm install -g germinate
brew install flashesofbrilliance/tap/germinate

Homebrew binary is macOS-only; Linux installs via npm.

Four primitives

belief-log

Append-only, OpenTelemetry-shaped JSONL: trace, span, confidence, risk, evidence, status. The trace of how conviction moved.

manifest

A registry of every surface, each stamped with a docset version. A projection older than the header is stale by definition.

handoff

A head with forward pickup pointers and a tail with provenance and lineage.

serializability check

Git serializes tracked files; this warns where advisory state escapes the lock. drift-check exits nonzero, so it works as a CI gate.

Not proven yet

For agents

MIT and public: read the source at github.com/flashesofbrilliance/germinate before you install it.

ARCS public goods · site llms.txt · site AGENTS.md