▸ Director: director-main-aaa5961e · 3 open-item(s), 1 need-you

A coordination ledger for your coding-agent work.

Decisions, open loops, handoffs: durable across sessions, repos, and weeks.

Memory tools answer “what does the agent know?”

Director answers “what is the state of the work?”

what was decided, and why · which loops are still open · where the work stopped · what still needs you

Nothing in a memory store ever closes. Your agents keep the ledger as they work; you never write a status update. You review.

$ curl -fsSL https://raw.githubusercontent.com/colinsurprenant/director/main/install.sh | sh

downloads a verified binary and wires Claude Code (pass --codex for Codex) · macOS, Linux, WSL · go install and prebuilt binaries also available

$ claude
  … deep into the pagination rework …
▸ decision   recorded · cursor pagination, not offset; offsets break under deletes
  …
▸ open-item  recorded · timezone edge case before the backfill merges
  … later …
▸ handoff    parked · cursor rework done · next: the backfill script · watch the p99

──────────── session ends · hours, days, or weeks pass ────────────

$ claude
> where were we?
▸ Director: acme-api-main-7c21e9d4 · 1 open-item(s), 1 need-you

## open-items
01KWJ4X2…  open-item  timezone edge case before the backfill merges  [risk:escalate]

## handoffs
01KWJ9RM…  handoff    cursor rework done · next: the backfill script · watch the p99

## decisions
01KWJ4W8…  decision   cursor pagination, not offset; offsets break under deletes
the same three facts on both sides of the gap: recorded as the session works, injected when the next one starts

how it works

An append-only log per repo. A deterministic fold. A push at session start.

$ director emit

Sessions record as they work: decision · open-item · handoff · note. Four kinds, one append-only NDJSON log per repo, lossless under concurrent writers.

$ director resolve

Loops close consciously. An open item stays visible until someone resolves it; nothing scrolls away, nothing silently vanishes.

$ director brief

A deterministic fold collapses the log into the machine digest, the human brief, and the fleet cockpit. Every session and the human read the same picture, byte-identical, verifiable.

SessionStart hook

Every new session starts from the injected CHARTER + digest: ground truth pushed at session start, not recalled by similarity. A cold re-entry starts from your parked handoff.

where it fits

Keep your tools. This is a different layer.

vs memory tools
They answer what does the agent know; Director answers what is the state of the work. Facts accumulate; loops open and close. Run both: they don’t overlap.
vs issue trackers
The tracker holds the work items. Director holds the narrative between tasks: the decision that reframed the task, the loop deferred while doing it, the handoff parked when the block ended.
vs a markdown file
Append-only integrity under concurrent writers, a byte-identical verifiable fold, lifecycle semantics, push-injection. Willpower is not a file format.