Skip to main content

Zero model drift between AI agents. Universal session continuity protocol and CLI for Claude, GPT, Gemini, and any LLM.

Project description

contextkeeper

Zero model drift between AI agents. Universal session continuity protocol and CLI for Claude, GPT, Gemini, and any LLM.

Install

pip install contextkeeper

Commands

contextkeeper init

Initialize contextkeeper state files in the current project. Auto-detects project type, generates STATE_VECTOR.json and HANDOFF.md, and creates a .workbench config file.

cd my-project
contextkeeper init

Options:

  • -p, --project — Project slug (default: directory name)
  • -t, --type — Project type override
  • --bridge — Bridge repo (e.g. yourname/workbench)

contextkeeper sync

Sync state files to your bridge repo.

contextkeeper sync

Options:

  • --bridge — Bridge repo override
  • --dry-run — Preview without pushing

contextkeeper status

Show status of all projects in the bridge repo.

contextkeeper status --bridge yourname/workbench

Options:

  • --bridge — Bridge repo
  • --json — Output as JSON

contextkeeper bootstrap

Generate a paste-ready bootstrap prompt for any AI chat.

contextkeeper bootstrap -p my-project --clipboard

Options:

  • -p, --project — Project slug (required)
  • --bridge — Bridge repo override
  • --clipboard — Copy to clipboard

contextkeeper doctor

Check environment and configuration health.

contextkeeper doctor

How It Works

  1. contextkeeper init creates structured state files in your project
  2. contextkeeper sync pushes them to a central bridge repo on GitHub
  3. contextkeeper bootstrap generates a prompt you paste into any AI chat
  4. The AI reads your state files and has full context in under 60 seconds

Requirements

  • Python 3.10+
  • git

License

MIT

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.0.tar.gz (7.0 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.0-py3-none-any.whl (10.4 kB view details)

Uploaded Python 3

File details

Details for the file contextkeeper-0.2.0.tar.gz.

File metadata

  • Download URL: contextkeeper-0.2.0.tar.gz
  • Upload date:
  • Size: 7.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for contextkeeper-0.2.0.tar.gz
Algorithm Hash digest
SHA256 0819f03583b0ded42fbf4489836d81057ca1a1a0ce8424c9e0e303b1b63b8768
MD5 4b3c0735946ed16165d461c82195ca55
BLAKE2b-256 c8552f79dc069296311bb600788edd0d6797bda0279260d6aaed8df2bc1d0ed7

See more details on using hashes here.

File details

Details for the file contextkeeper-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: contextkeeper-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 10.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for contextkeeper-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 76adac426de8be3aa63aa850dbdf7686387a4263fc68b844e421c14b2522ea0e
MD5 5e003669c548204c8b7b245eaa28ca7e
BLAKE2b-256 67e24de45b4c651a342ce5e1e8a05c1f1a8752dfddedd9c0f50f39328c089d32

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