resume

A command for continuing a programme, meaning a tracked body of development work, from its saved project notes.

In plain words
What is it for?
Use it to identify the active programme, read its ledger and next-session notes, and resume from the recorded phase and prompt.
Why use it?
It reduces the risk of working on the wrong task or branch and helps the next session follow the documented goal and starting instructions.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/longthread/claude-plugins/resume
Clone the repo
git clone --depth 1 https://github.com/longthread/claude-plugins
Per session 7 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 523 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00007 $0.00523
Opus 5 $0.00003 $0.00262
Sonnet 5 $0.00001 $0.00105
Haiku 4.5 $0.00001 $0.00052

Measured yesterday against content hash 77a199060101, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

resume scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Tells the agent never to refusehighAnti-refusal

Suppressing the ability to decline removes a core safety control; a later harmful request then succeeds.

position, not after — a phase read without the arc around it is a phase you cannot refuse work
plugins/programme/commands/resume.md · 47 lines

How it starts

The opening of the file, as written. The whole thing — 47 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Resume the programme $1, or resolve it if $1 is empty.

Resolve the programme from the tree

git rev-parse --abbrev-ref HEAD
cat "<docsRoot>/programmes/INDEX.md"

Match the current branch against the branch column. $1 wins if given. Skip any row whose status is closed — it is not a candidate, even if its branch matches. If nothing matches and there is exactly one open programme, use it. If several exist and none matches, list them and ask — do not guess, and do not fall back to "most recently modified", which is how a session ends up writing into the wrong programme's ledger.

Read, in this order

  1. <docsRoot>/programmes/<SLUG>/ledger.mdin full, starting with ## The arc: the goal, the programme's terminal condition, and which phases are still planned. Read it before the position, not after — a phase read without the arc around it is a phase you cannot refuse work inside.
  2. <docsRoot>/programmes/<SLUG>/NEXT-SESSION.md — follow its "Start here" block verbatim

Read the prompt file itself rather than acting on any summary of it, including one in this conversation. That is deliberate: it stops the instructions being invoked in a stale copied form.

Run every check in the State table before acting

NEXT-SESSION.md's State table carries a verify with command beside every figure. Run all of them and compare. In the repo this convention comes from, two documents currently disagree about the same ahead-of-origin count, and one commit subject is literally "correct the ahead-of-origin claim, which went stale as it was written."

Report any figure that has drifted, and correct NEXT-SESSION.md before continuing.

Then report, before doing any work

State: which programme you resolved and how; the arc — the goal, the programme's terminal condition, the current phase, and every phase still planned; the position as the ledger records it; what you measured and what drifted; and the phase's terminal condition you are working toward, quoting its command and expected output. Then ask whether to proceed.

Read the full file on GitHub · 47 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 47 lines · 7 tokens per session scan C 77a199060101

Subscribe to this mod's changes

resume is a command published in the GitHub repository longthread/claude-plugins (1 stars, last pushed 11d ago), licensed MIT. It adds 7 tokens to every session and 523 once invoked, about $0.0000 per session on Opus 5. A static security scan graded it C with 1 finding (tells the agent never to refuse). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.