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

  • Portable context bundle -- knowledge, decisions, conventions, skills, state, preferences, session history
  • Team conventions -- shared behavioral rules (git workflow, environment, communication) across all tools
  • 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 -- 27 tools, 15 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 gh CLI

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.2.tar.gz (698.7 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.2-py3-none-any.whl (114.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: context_teleport-0.5.2.tar.gz
  • Upload date:
  • Size: 698.7 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.2.tar.gz
Algorithm Hash digest
SHA256 428150b5942b23260e22d5aaa4c33cde35cdf5151bef218b0ae11f17b7ff860e
MD5 1f02f84c37ef796b815d58b353cedc41
BLAKE2b-256 ee6fe35c569dada3fe8341f6a0b0006dcd0f955599012ddfe517fe161c118b29

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for context_teleport-0.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 691fa616bebb6bf3a3bcaa159d4ce3cd8a9c15b3e1d6a7df9e3f205356d5db7d
MD5 e92a321e3fa6424d389e5a16c43dec22
BLAKE2b-256 a69f60f0e196ac8cb70d5166c367d87d3e4e917f082fbca2a1d9ef9ec801c8fd

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