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.5.0.tar.gz (695.1 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.5.0-py3-none-any.whl (114.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: context_teleport-0.5.0.tar.gz
  • Upload date:
  • Size: 695.1 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.5.0.tar.gz
Algorithm Hash digest
SHA256 c1ff1010d41d9c4575f6e0d20d104e9a0b18f974c16625f5c3a6095d8d329a6a
MD5 c4980d830581509705d9b3daee72b8ee
BLAKE2b-256 c740619735cdf45907d3b6f0d61fe91c2da1ad70fd2f76552d0532c1a149100b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for context_teleport-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0245dc93c7ca12d38a2308cb1e6fedd9f2ea7295a1a34ecfe73edb658167fa32
MD5 8dedad57f3ce01455c5509a2bef85f70
BLAKE2b-256 fa979938df6863a1675e577a91c9f5de3ab97a2a9523e74df2b7e43467b7fa24

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