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 -- 32 tools, 16 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
  • Activity board -- team check-in/check-out with staleness detection
  • Lifecycle hooks -- Claude Code hooks for context persistence across compaction and subagents
  • Markdown navigation -- outline, section extraction, and table listing within entries
  • 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.4.tar.gz (728.0 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.4-py3-none-any.whl (121.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: context_teleport-0.5.4.tar.gz
  • Upload date:
  • Size: 728.0 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.4.tar.gz
Algorithm Hash digest
SHA256 21221b81b1a192630785b01d2e0c9c0328be2341f8f86148151aa46701649bf2
MD5 ddcbb243050b0c064ee80942d776ce30
BLAKE2b-256 69e573285b55ffea4ce0ed3e1bfabfed0708ff59c63ca7eb876f3c5b164d957b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for context_teleport-0.5.4-py3-none-any.whl
Algorithm Hash digest
SHA256 7c7c2ef4b0e7e4448ae031ae1624123d25580a2346b66b6472f0676f67ef6875
MD5 2ab7f6cb841baa360fa01764622fcdfc
BLAKE2b-256 68113d387106922f5b862b7632bac9ad92c42bbc9c9050c9e2e735e3634a7321

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