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.5.tar.gz (730.6 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.5-py3-none-any.whl (122.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: context_teleport-0.5.5.tar.gz
  • Upload date:
  • Size: 730.6 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.5.tar.gz
Algorithm Hash digest
SHA256 f4251fe09fdd0bd8d564f86f3e7a4af4777e64f695a28d68a58b2c926beaeaf0
MD5 3006e0c9a8cceaeee6466cc897a9490d
BLAKE2b-256 0e93f7895fd2f3006cb6941bc9aba271af1955045385c7482faef51afc9f3d7f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for context_teleport-0.5.5-py3-none-any.whl
Algorithm Hash digest
SHA256 f109281b68b1e28f1ff82be9a80299feebf326d605e32a12d53e869f5c987621
MD5 23e40c5137b379197c4fef92bca83ba4
BLAKE2b-256 5bcc83b0eb62ad1aeba4f68a76c22a580eb4028febf9fa938562ec429c94c2bf

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