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, 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.