Repository navigation
Install: uvx greenproof@0.5.0 --version or pipx install greenproof==0.5.0 (PyPI).
Milestone M6 (SPEC section 15): six more agents on the hook protocol. All six are
experimental: the files follow each vendor's documentation as read on 2026-11-12 and none has
completed a real-CLI block-and-release run yet. Real payloads were captured from Claude Code
2.1.322 (no timestamp key, which the Copilot rule below relies on) and Antigravity CLI 1.0.8,
which sends terminationReason: "NO_TOOL_CALL" for a normal stop where its documents say
model_stop; both values run the gate.
Added
check --hookandsession-start --hookacceptcopilot,qwen,droid,antigravity,
openhandsandauggie. Each reads its CLI's own payload (session id, start directory, and
where there is one the field that marks a stop that is not the model finishing, which is
skipped) and answers in that CLI's output format; the same state, replay and release rules apply.init --agentswrites the hook files for them:.github/hooks/greenproof.json,
.qwen/settings.json,.factory/hooks.json,.agents/hooks.json,.openhands/hooks.json
and.augment/settings.json. Merging, ownership and exit 4 on an unusable file work as for
the other agents. Timeouts use each CLI's unit: seconds for Qwen (capped at 999, because Qwen
reads 1000 or more as milliseconds), Droid, Antigravity and OpenHands,timeoutSecfor
Copilot, milliseconds for Auggie. Droid's file is keyed directly by event name, and
Antigravity's greenproof entry is the keygreenproof.- Experimental adapters print a warning when named, and Qwen Code and Droid print a note about
approving or reviewing the hooks.--agents autonever installs an experimental adapter. It
now also detects Copilot (.github/hooks/or.github/copilot-instructions.md), Qwen
(.qwen/) and Droid (.factory/), but only for an adapter that is not experimental, so
none of them is picked yet. scripts/e2e/capture_payload.py, a hook command that appends its stdin, arguments and the
*_PROJECT_DIRand*_SESSION_IDenvironment variables to the file named by
GREENPROOF_CAPTURE, for recording real payloads before an adapter is marked supported. It is
not part of the wheel.- README: the agents that have no hook that can block a stop (Cline, Roo Code, Windsurf, Zed,
Warp, Aider, Continue, Kiro, Devin, Jules), which rely on AGENTS.md and CI, and Goose, Junie,
Amp and Kilo Code as planned.
Changed
- Under
--hook claude, a payload with atimestampkey is Copilot's (Copilot CLI and VS Code
also run the hooks in.claude/settings.json, and treat exit 2 from a stop hook as a
warning). When a.github/hooks/*.jsonfile holds a greenproof--hook copilotentry for the
event, the Claude hook defers: exit 0, no output, no state written. Otherwise it answers in
Copilot's format. hooks.pykeeps one table of per-agent protocols instead of per-agent branches; the output
for Claude Code, Cursor, Codex CLI, Gemini CLI and OpenCode is unchanged.inittakes the
notes and warnings it prints from attributes of each adapter module.- README: the Gemini CLI row points to Antigravity CLI, its successor.
Full changelog: v0.4.1...v0.5.0