Skip to main content

Portable, git-backed context store for AI coding agents

Project description

Context Teleport

Schema v0.4.0 Python 3.11+ License AGPL-3.0 CI

Portable, git-backed context store for AI coding agents.


The problem

AI coding agents accumulate deep context over sessions -- architecture decisions, codebase knowledge, workflow preferences. That context is trapped in tool-specific formats on a single machine. There is no standard way to move it between devices, share it across a team, or use it with a different agent tool.

What it does

Quickstart

# Initialize a context store
uvx context-teleport init --name my-project

# Register your agent tool
uvx context-teleport register claude-code

# Start working -- the agent manages context from here
You: "Save that we're using hexagonal architecture with FastAPI"
Agent: [calls context_add_knowledge] Done.

You: "Record the decision to use PostgreSQL"
Agent: [calls context_record_decision] Decision recorded.

You: "Sync with the team"
Agent: [calls context_sync_push] Pushed 2 changes.

Documentation

Full documentation at mauricio-xx.github.io/context-teleport.

  • Getting Started -- installation, quickstart, first project tutorial
  • Guides -- team setup, multi-agent workflows, conflict resolution, EDA integration
  • Reference -- CLI, MCP tools/resources/prompts, schema, adapters
  • Architecture -- system design with TikZ diagrams
  • Examples -- solo developer, multi-agent team, EDA project

Supported tools

Tool Import Export MCP Registration Skills
Claude Code Yes Yes .claude/mcp.json Yes
OpenCode Yes Yes opencode.json Yes
Codex Yes Yes -- Yes
Gemini Yes Yes .gemini/settings.json Yes
Cursor Yes Yes .cursor/mcp.json Yes

Contributing

See CONTRIBUTING.md for development setup, or the full contributing guide for testing, adding adapters, and adding EDA parsers.

All contributions require signing the CLA.

License

AGPL-3.0-or-later.

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

context_teleport-0.4.0.tar.gz (688.9 kB view details)

Uploaded Source

Built Distribution

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

context_teleport-0.4.0-py3-none-any.whl (110.6 kB view details)

Uploaded Python 3

File details

Details for the file context_teleport-0.4.0.tar.gz.

File metadata

  • Download URL: context_teleport-0.4.0.tar.gz
  • Upload date:
  • Size: 688.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for context_teleport-0.4.0.tar.gz
Algorithm Hash digest
SHA256 1837bcde4d935b12339a1792962d96ca2c2444735930abb54baa221513439303
MD5 0f2f75107be8856706b7b08cb5debf26
BLAKE2b-256 14b2c22bdf9236263fc8743e10b7f84bf11d50996bb1d07e32bec5dd8a89b8b1

See more details on using hashes here.

File details

Details for the file context_teleport-0.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for context_teleport-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ecfb4f9b6e321f61b1c8c52caca5f6d9a08a305729d56f275dd2beebf8a699e7
MD5 5ea5b16ba06835d53ee030f1b3af6d41
BLAKE2b-256 418359a63bbb62fe42a02e64e334cb667d07c696b10752cf2aa4f8065c18cac4

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