Portable, git-backed context store for AI coding agents
Project description
Context Teleport
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
- Portable context bundle -- knowledge, decisions, skills, state, preferences, session history
- Git-backed sync -- push/pull with section-level merge for multi-agent workflows
- Cross-tool adapters -- import/export between Claude Code, OpenCode, Codex, Gemini, and Cursor
- Agent skills -- shareable SKILL.md with usage tracking, feedback, and auto-improvement
- MCP server -- 23 tools, 13 resources, 4 prompts for any MCP-compatible agent
- Context scoping -- public, private, and ephemeral boundaries
- LLM conflict resolution -- agents inspect and resolve merge conflicts via MCP tools
- EDA domain support -- parsers for LibreLane, OpenROAD, Magic DRC, Netgen LVS, Liberty
- GitHub issue bridge -- import issues as knowledge or decisions via
ghCLI
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
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 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1837bcde4d935b12339a1792962d96ca2c2444735930abb54baa221513439303
|
|
| MD5 |
0f2f75107be8856706b7b08cb5debf26
|
|
| BLAKE2b-256 |
14b2c22bdf9236263fc8743e10b7f84bf11d50996bb1d07e32bec5dd8a89b8b1
|
File details
Details for the file context_teleport-0.4.0-py3-none-any.whl.
File metadata
- Download URL: context_teleport-0.4.0-py3-none-any.whl
- Upload date:
- Size: 110.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ecfb4f9b6e321f61b1c8c52caca5f6d9a08a305729d56f275dd2beebf8a699e7
|
|
| MD5 |
5ea5b16ba06835d53ee030f1b3af6d41
|
|
| BLAKE2b-256 |
418359a63bbb62fe42a02e64e334cb667d07c696b10752cf2aa4f8065c18cac4
|