One shared handoff log so Codex and Claude Code stop forgetting each other's work
Published
How does this AI workflow work?
- Replaces: re-explaining context to each coding agent at the start of every session, and decisions lost in chat history.
- Results: a hook after every agent turn appends one line to a handoff.md file, and each agent reads the last 20 lines before it starts.
- In 7 days the agents wrote 1,556 lines on their own.
- Codex builds while Claude reviews, which caught a change that had passed 40 tests but was still broken.
- What to connect: Codex and Claude Code on one machine, with no server and no extra bill.
- One routing file context.md under 400 words, and one AGENTS.md per repo (CLAUDE.md just points to it).
- A post-turn hook in each agent, and one config file that maps light, deep and code-deep tiers to models.
- Known limits: required reading grew from about 6,000 to 20,000 words, and an append-only decisions file contradicted itself, so decisions are now add-or-replace.
- Who it's for: developers who run more than one coding agent or bot daily and want shared memory without a vector database.
From the Morning Tokens issue of Nov 2, 2026