Skip to main content

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

PyPI version Python License npm

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+
  • git on PATH
  • GitHub PAT token (for sync)

License

MIT © TheRealDataBoss

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

contextkeeper-0.2.7.tar.gz (12.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

contextkeeper-0.2.7-py3-none-any.whl (18.3 kB view details)

Uploaded Python 3

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

Hashes for contextkeeper-0.2.7.tar.gz
Algorithm Hash digest
SHA256 0e2437d87e2a6b9d9a6666789ccc12030bad4cec204c0bb4ab2f0ca19e3c811f
MD5 a4497322481cb6046df84d9122f329ca
BLAKE2b-256 2a362820226499a07592e4fa2c37004f56101d325bc8cfb6cab54dc97b9b3f24

See more details on using hashes here.

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

Hashes for contextkeeper-0.2.7-py3-none-any.whl
Algorithm Hash digest
SHA256 9b73de3dad0693311cdcdcb06ba2b47f7718861cc0d21c730980851c2eacc6c7
MD5 74275c96bac1e56125ef4a4d65c3b7df
BLAKE2b-256 7fdf3d98c4119788ce92e7b79a6f669030843ff86b6281f075f98d4641716782

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page