= Claude Session Kit
:description: Token-aware session workflow: handoff, open decisions, recap, sweep — for Claude Code, Cowork, and claude.ai
:revdate: 2026-07-20
Shared idea: docs/session/ is an OKF-inspired AsciiDoc knowledge bundle —
the memory shared between a human who forgets across days and an AI that
forgets across sessions.
== Contents
* CLAUDE-additions.md — append below the Karpathy guidelines in your CLAUDE.md
* .claude/commands/ — /handoff, /decide, /recap, /sweep (Claude Code)
* .claude/skills/session-handoff/ — detection skill (Claude Code, Cowork, claude.ai)
* .claude/settings.json — SessionStart hook: detects HANDOFF.adoc, offers before reading
* claude-ai/project-instructions.txt — paste block emulating the workflow in claude.ai
== Install: Claude Code (VS Code / terminal)
1. Merge CLAUDE-additions.md into your repo's CLAUDE.md (below the
Karpathy base: curl -o CLAUDE.md https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/refs/heads/main/CLAUDE.md).
2. Copy .claude/ into the repo root. If you already have a
.claude/settings.json, merge the hooks block instead of overwriting.
3. mkdir -p docs/session — the bundle files are created on first use.
4. Commands: /handoff, /decide, /recap, /sweep. The hook + skill handle
session-start detection and wrap-up suggestions automatically.
== Install: Claude Cowork
Cowork supports skills but not Claude Code slash commands or hooks.
1. Install the session-handoff skill (copy the folder into your skills
directory, or add it via the app's skill/capability settings).
2. Keep CLAUDE.md (with the additions) in the project folder Cowork
works in — it reads project context files.
3. The skill covers everything the hook/commands do in Claude Code:
start-of-session detection, wrap-up offers, handoff writing, and the
open-decisions discipline. Trigger manually by saying "write a
handoff" / "recap" / "what's still open".
== Install: claude.ai (web/app)
No filesystem — project knowledge is the bundle, and you are the write
path (chats can read project knowledge but cannot write it).
1. Create a Project. Paste claude-ai/project-instructions.txt into
Project > Settings > Custom instructions.
2. Create empty project-knowledge documents: HANDOFF, OPEN_DECISIONS,
DECISIONS.
3. Use /handoff, /recap, /decide in chat; paste the AsciiDoc blocks
Claude outputs back into the matching documents. That paste step is
the manual price of the platform.
4. Optional: claude.ai also supports uploading custom skills
(Settings > Capabilities) — the session-handoff skill folder can be
zipped and uploaded, but the paste-back step remains either way.
== Usage numbers (Claude Code)
The exporter statusline (.claude/statusline.sh) shows model, context %,
5h % and 7d % live — zero context cost — and mirrors the full JSON to
~/.claude/state/usage.json on every update. Consumers:
* /tokens — one-line readout in-session (~50-80 tokens of context, use freely)
* session-handoff skill — numeric thresholds: ctx >= 70% suggests /handoff,
>= 85% suggests it firmly; warns when 5h >= 80% or 7d >= 90%
* your own terminal — cat ~/.claude/state/usage.json (zero context cost)
Requires python3; no jq. If you already have a statusline, add the two
exporter lines (mkdir + printf to the state file) to it instead.
== Token economics
Everything follows progressive disclosure: detection reads existence and
dates, not content; recaps read the bundle, not the repo; sweeps ask
before spending; handoffs reference by path instead of duplicating.
Files stay under 60 lines so reading them stays cheaper than
re-explaining.
claude-session-kit.zip
Newer:
claude-session-kit.zip
incorporate the session kit