Agent Wills GitHub

When an agent dies, it leaves a will.

A tiny open-source plugin for Claude Code. When a session or subagent ends, it writes a few hundred tokens of will.md: what's done, what's unfinished, what to watch for. The next agent in that folder inherits it.

/plugin marketplace add VedSoni-dev/agent-wills
/plugin install agent-wills@agent-wills

Type these in Claude Code, then restart it. Needs Node 18+.

A real will, and its heir

First, the will a real session left when it ended. Then the session that started in the same folder a minute later.

# Will of afd03a · fix applycoupon negative total
died 2026-11-12 15:06 · closed · 0 min · 1 prompt · main · written by claude
I clamped applyCoupon so totals stop going negative, and node cart.test.js passes. FREESHIP was left for later, as asked.
## Bequeathed
`cart.js`: `applyCoupon` returns `Math.max(0, discounted)`, so the clamp covers every coupon
`node cart.test.js` now prints `ok`
## Unfinished business
FREESHIP coupon (4.99 off when sum > 50) not implemented in `cart.js`
## Last wishes
Add FREESHIP to `applyCoupon` in `cart.js`, gated on the sum being over 50

.claude/wills/2026-11-12-fix-applycoupon-negative-total-afd03a06e4.will.md · 594 bytes

$ claude ⎿ SessionStart:startup says: 📜 Inherited 1 will. Latest: “I clamped applyCoupon so totals stop going negative, and node cart.test.js passes. FREESHI…” > where were we? ⏺ We were fixing the negative-total bug in applyCoupon, and that part is done. The FREESHIP coupon is the open item. Not done: - FREESHIP (4.99 off when the sum is over 50) isn't in cart.js yet. The previous session left it for later at your request.

The heir also checked the will against the code before answering.

Small on purpose

Plain markdown

One file per death in .claude/wills/, git-ignored by default. No database, no background service, no dependencies.

Exit is never held up

A plain will is written in milliseconds. The model rewrites it in the agent's voice in a detached process, after Claude Code has closed.

Subagents too

Every subagent leaves a short will in .claude/wills/subagents/. Ask for one in the agent's own words with /will.

Who writes the will

Secrets are redacted before anything is written or sent. If a model fails, the plain will stays.

EngineWhat it usesPicked when
publikThe publik API (publik-fast). New accounts get free credit.You have a publik key
claudeYour own Claude Code: claude -p with Haiku, no tools, nothing saved.claude is on your PATH
plainNo model. Files touched, last ask, last words, errors. Nothing leaves your machine.Nothing else is set up