The context window fills, the session ends, and the next one starts blind.

A long run with Claude Code is bounded by its context window. When it fills the session ends, and everything the model knew about the work goes with it. The next session opens cold. The operator re-explains the project from memory, or lets the model rediscover it the slow way.

ae-handover is the binary that keeps the thread. At the end of a session it writes a numbered document into the project's archive, recording where the work stopped; at the start of the next, it loads the latest back into context before a word is typed. It is the continuity member of the ae-sys harness, sharing the same project config the other two binaries read, and built as a single Rust executable, installed and upgraded independently of the other two.

A numbering scheme, a per-project archive, and a launcher.

ae-handover is three small parts. A sequence assigns each document the next number for the project. An archive under the operator's home directory keeps every document, one folder per project. A launcher opens a fresh session with a chosen document already in context.

Anatomy ae-handover
01 Numbering
one running sequence per project, three digits, four past 999
02 Archive
one folder per project under the operator's home directory
03 Resolver
reads the shared project config to locate that folder
04 Latest
the most recent document, addressed without naming a number
05 Auto-load
the newest document injected at every fresh session start
06 Launcher
opens a new session with a chosen document already loaded

Write at the end, load at the start.

One thread crosses the gap between two sessions. The closing session writes its state to the next number in the archive. The opening session reads it back: either picked up automatically as the latest, or launched against a specific earlier document by number.

the thread across sessions ae-handover
Session ending state written to the next number in the project's archive
Auto-load on start
01 Detect
a fresh session begins
02 Resolve
the project's latest document, by number
03 Inject
its contents loaded into context before any input
Launch a chosen point
Address
a specific earlier document, by number
Open
a new session spawned with that document
Inject
its contents loaded into context before any input
Session opening the previous thread already in hand

Small surface, one job.

The command surface stays narrow because the work is narrow: report the next number, list the archive, point to the latest, name its folder, or launch a session against the latest or a chosen number. Most days it is one command, opening the next session where the last one stopped.

What it gives you ae-handover
Launch
Open a new session against the latest.
Next
The project's next number.
List
Every document, in order.
Use N
Launch from a chosen number.
Latest
The most recent, by path.
Dir
The project's archive folder.

Every session writes one. The next one reads it.

The archive runs deep. ae-handover's own project has kept a single unbroken thread of state across days and machines, one numbered document at a time.

Before / after ae-handover
Without it
A finished session takes its thread with it. The next one starts cold and re-derives the work.
With ae-handover
The thread is written to a numbered document, and the next session opens already holding it.
work