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.
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, not on PyPI yet. Working: the spec (SPEC.md), the init /
validate / status CLI, a full worked example
(examples/demo-project/), and an Agent Skills
skill (.agents/skills/ai-baton/) that's been triggered live in
Claude Code but not yet in Codex or Cursor. 16 tests pass locally. Not
built: PyPI packaging, 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.1.tar.gz.
File metadata
- Download URL: ai_baton_tool-0.0.1.tar.gz
- Upload date:
- Size: 21.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2009b6a1cdaf9f6a8064d29b900ae922b48c454903d66b5360f4a73026b30644
|
|
| MD5 |
be3c2a93fcdc773bdc2701506791593f
|
|
| BLAKE2b-256 |
096c91c5ecef2dcee3976a10f12e2e95f84134665ad3c56eb284abea11c15829
|
Provenance
The following attestation bundles were made for ai_baton_tool-0.0.1.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.1.tar.gz -
Subject digest:
2009b6a1cdaf9f6a8064d29b900ae922b48c454903d66b5360f4a73026b30644 - Sigstore transparency entry: 2412550681
- Sigstore integration time:
-
Permalink:
wszzs/ai-baton@102fdac0c0d6fde305d27eb2535747e505b34086 -
Branch / Tag:
refs/tags/v0.0.1 - Owner: https://github.com/wszzs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@102fdac0c0d6fde305d27eb2535747e505b34086 -
Trigger Event:
release
-
Statement type:
File details
Details for the file ai_baton_tool-0.0.1-py3-none-any.whl.
File metadata
- Download URL: ai_baton_tool-0.0.1-py3-none-any.whl
- Upload date:
- Size: 10.7 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 |
5e4afb9adb6dd46732e17664a8e2026796d9fc99c4d2bffa5eeaee5365f38061
|
|
| MD5 |
c6b3e7ee285f4a7da0a764c4b7ed7a5f
|
|
| BLAKE2b-256 |
3f2d11158d3b09988249c23315a164a9ddf8cdddcb6be96370f397585dd0af04
|
Provenance
The following attestation bundles were made for ai_baton_tool-0.0.1-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.1-py3-none-any.whl -
Subject digest:
5e4afb9adb6dd46732e17664a8e2026796d9fc99c4d2bffa5eeaee5365f38061 - Sigstore transparency entry: 2412550786
- Sigstore integration time:
-
Permalink:
wszzs/ai-baton@102fdac0c0d6fde305d27eb2535747e505b34086 -
Branch / Tag:
refs/tags/v0.0.1 - Owner: https://github.com/wszzs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@102fdac0c0d6fde305d27eb2535747e505b34086 -
Trigger Event:
release
-
Statement type:
