ai-baton
Portable, auditable, file-first handoff protocol for AI assistants.
Lets you move between AI tools — Claude Code, Codex CLI, Cursor, or
anything else that reads/writes files — on the same long-running project
without re-explaining context every time. State lives in plain Markdown +
YAML files in your own repo: a memory/ for durable facts and decisions,
a status/CURRENT_STATUS.md for what's happening right now, an
append-only evidence/ trail, handover/ snapshots, and archive/ for
superseded plans. No server, no vector DB, no vendor plugin required —
every change is just a git diff.
Requires local filesystem access — this works with tools that run on your
machine or have been given access to a folder (Claude Code, Codex CLI,
Cursor, Windsurf, Claude Desktop with a filesystem connector, etc.). Plain
web ChatGPT or web Claude.ai chat, without file access, can't read
PROTOCOL.md at all, regardless of Agent Skills support.
Not the first system aiming at cross-tool AI memory — Mem0, OpenMemory,
and Letta solve overlapping problems with a vector store and/or an agent
runtime. This makes the opposite trade-off: zero infrastructure and
git-native auditability, at the cost of semantic search and automatic
extraction. See docs/comparison.md.
Status
Pre-alpha. pip install ai-baton-tool (PyPI distribution name differs
from the ai-baton command — an existing unrelated package blocked that
name). Working: the spec (SPEC.md), the init / validate / status /
list / skill install CLI, a default workspace convention
(~/ai-baton-workspace/<project-name>/, discoverable across tools/sessions
via ai-baton list), a full worked example (examples/demo-project/),
and an Agent Skills skill — ai-baton skill install puts it where Claude Code and Codex CLI look for it, triggered
live in Claude Code but not yet in Codex or Cursor. validate also flags
well-known credential formats (AWS/GitHub/Slack keys, private key blocks)
as a heuristic safety net, not a full secrets scanner, and warns (per-
project configurable via .ai-baton.json) when memory/ gets large
enough to be a real token cost every session. 31 tests pass locally. Not
built: semantic search (by design) and any automated measurement of
handoff effectiveness (methodology sketched in
docs/metrics.md, nothing wired up).
Quick orientation
docs/quickstart.md— install and try it.SPEC.md— the protocol.docs/comparison.md— vs. Mem0 / OpenMemory / Letta / Letta Code.docs/metrics.md— how we'd measure handoff quality.examples/demo-project/— worked example..agents/skills/ai-baton/SKILL.md— install once, an AI tool follows the protocol without being reminded.
License
MIT — see LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ai_baton_tool-0.0.9.tar.gz.
File metadata
- Download URL: ai_baton_tool-0.0.9.tar.gz
- Upload date:
- Size: 36.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
df29ad1a87189339f226f0d2d28c9f87ef21bb92202359a79c80edde702a10ae
|
|
| MD5 |
3226ca69dbea944311569f5f5802d957
|
|
| BLAKE2b-256 |
9754a9d2315974d27cbec49df3fdb017e773914e185809c36ac8a66f754973c7
|
Provenance
The following attestation bundles were made for ai_baton_tool-0.0.9.tar.gz:
Publisher:
publish.yml on wszzs/ai-baton
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ai_baton_tool-0.0.9.tar.gz -
Subject digest:
df29ad1a87189339f226f0d2d28c9f87ef21bb92202359a79c80edde702a10ae - Sigstore transparency entry: 2413998017
- Sigstore integration time:
-
Permalink:
wszzs/ai-baton@9d3445f5d274ba626c4a198b19dfa6a57e7a5ff4 -
Branch / Tag:
refs/tags/v0.0.9 - Owner: https://github.com/wszzs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@9d3445f5d274ba626c4a198b19dfa6a57e7a5ff4 -
Trigger Event:
release
-
Statement type:
File details
Details for the file ai_baton_tool-0.0.9-py3-none-any.whl.
File metadata
- Download URL: ai_baton_tool-0.0.9-py3-none-any.whl
- Upload date:
- Size: 20.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c3a190370ab120a4fb49e461894bd8ba85a66e830d9b78a36fc5d656a15834b9
|
|
| MD5 |
88b8eb97a5136d3f8945a961e1016062
|
|
| BLAKE2b-256 |
5d83c4dccb0b550cab4ca7a0cbb8564444809151c5b4b7537be322853ea268c3
|
Provenance
The following attestation bundles were made for ai_baton_tool-0.0.9-py3-none-any.whl:
Publisher:
publish.yml on wszzs/ai-baton
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ai_baton_tool-0.0.9-py3-none-any.whl -
Subject digest:
c3a190370ab120a4fb49e461894bd8ba85a66e830d9b78a36fc5d656a15834b9 - Sigstore transparency entry: 2413998037
- Sigstore integration time:
-
Permalink:
wszzs/ai-baton@9d3445f5d274ba626c4a198b19dfa6a57e7a5ff4 -
Branch / Tag:
refs/tags/v0.0.9 - Owner: https://github.com/wszzs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@9d3445f5d274ba626c4a198b19dfa6a57e7a5ff4 -
Trigger Event:
release
-
Statement type:
