Zero model drift between AI agents. Universal session continuity CLI and Python library for Claude, GPT, Gemini, and any LLM.
Project description
contextkeeper
mcp-name: io.github.TheRealDataBoss/contextkeeper
Zero model drift between AI agents. Universal session continuity protocol and CLI for Claude, GPT, Gemini, and any LLM.
The Problem
You switch from Claude to GPT mid-project. You open a new chat. You spend 20 minutes re-explaining your stack, your decisions, your constraints. Again. The AI confidently suggests something you already ruled out three sessions ago.
Every AI session starts with amnesia. contextkeeper fixes this.
It gives every project a structured state file — synced to GitHub — that any AI agent can read in under 60 seconds.
Install
pip install contextkeeper
# or
npm install -g contextkeeper
How It Works
contextkeeper init → generates STATE_VECTOR.json + HANDOFF.md contextkeeper sync → pushes state to your GitHub bridge repo contextkeeper bootstrap → generates a paste-ready prompt for any AI paste it in → full context in < 60 seconds
Works with Claude, ChatGPT, Gemini, Llama, Mistral, or any LLM that can read a URL.
Quickstart
cd my-project
contextkeeper init
# sync state to GitHub
contextkeeper sync
# generate bootstrap prompt and copy to clipboard
contextkeeper bootstrap -p my-project --clipboard
# paste into Claude, GPT, Gemini — full context restored instantly
Commands
| Command | Description |
|---|---|
contextkeeper init |
Auto-detect project type, generate STATE_VECTOR.json + HANDOFF.md |
contextkeeper sync |
Push state files to your GitHub bridge repo |
contextkeeper bootstrap |
Generate paste-ready AI prompt, optionally copy to clipboard |
contextkeeper status |
Show all tracked projects in the bridge repo |
contextkeeper doctor |
8-point health check — token, git, schema, GitHub API |
init
contextkeeper init [-p PROJECT] [-t TYPE] [--bridge REPO]
sync
contextkeeper sync [--bridge REPO] [--dry-run]
bootstrap
contextkeeper bootstrap -p PROJECT [--bridge REPO] [--clipboard]
status
contextkeeper status [--bridge REPO] [--json]
doctor
contextkeeper doctor
Requirements
- Python 3.10+
giton PATH- GitHub PAT token (for sync)
License
MIT © TheRealDataBoss
Project details
Release history Release notifications | RSS feed
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 contextkeeper-0.2.7.tar.gz.
File metadata
- Download URL: contextkeeper-0.2.7.tar.gz
- Upload date:
- Size: 12.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0e2437d87e2a6b9d9a6666789ccc12030bad4cec204c0bb4ab2f0ca19e3c811f
|
|
| MD5 |
a4497322481cb6046df84d9122f329ca
|
|
| BLAKE2b-256 |
2a362820226499a07592e4fa2c37004f56101d325bc8cfb6cab54dc97b9b3f24
|
File details
Details for the file contextkeeper-0.2.7-py3-none-any.whl.
File metadata
- Download URL: contextkeeper-0.2.7-py3-none-any.whl
- Upload date:
- Size: 18.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9b73de3dad0693311cdcdcb06ba2b47f7718861cc0d21c730980851c2eacc6c7
|
|
| MD5 |
74275c96bac1e56125ef4a4d65c3b7df
|
|
| BLAKE2b-256 |
7fdf3d98c4119788ce92e7b79a6f669030843ff86b6281f075f98d4641716782
|