Agent Diff

Agent Diff is an agent-first CLI for repo-local Codex skills. It routes actions through declared events, machine-checkable contracts, observed diffs, run ledgers, and release verification receipts.

Install

npm install -g @nguyenduclong1147/agent-diff

Local fallback:

npm install --save-dev @nguyenduclong1147/agent-diff
npm exec -- agent status --summary

Basic Flow

agent bootstrap
agent bootstrap --apply
agent status
agent doctor
agent init writer
agent validate writer
agent writer write path=sandbox/a.txt text=hello

bootstrap --apply manages only Agent Diff marked blocks in AGENTS.md and .gitignore; project content outside those blocks is preserved.

Release Flow

agent adapter run npm ready --apply
agent release next --summary
agent release publish-apply --version <version> --apply
agent release dashboard --summary

Publishing is tag-driven through GitHub Actions Trusted Publisher/OIDC. release publish-apply --apply runs the guarded version bump, ready, preflight, commit, tag, push, and post-publish verification path through the CLI; release next --summary remains the read-only operator guide.

In GitHub Actions, the trusted publish workflow runs npm run publish:preflight -- --ready-verified immediately after npm run ready so it can reuse that verified gate without running the full ready suite twice. The flag fails closed outside the tag-triggered workflow context.