mapctx

A multi-agent project context workspace for Markdown tasks, roadmap visualization, and sync workflows.

MapCtx is an AI-first workspace for planning and execution with:

• local task boards in TASKS.md
• detailed task docs in tasks/T-XXX.md
• Kanban/Roadmap UI (VS Code + OpenCode plugin)
• bidirectional sync with GitHub Issues + GitHub Projects v2 (via @mapctx/sync-engine)

Install extension: VS Code Marketplace

What is in this monorepo

• packages/vscode-extension/: VS Code/Cursor extension (mapctx)
• packages/opencode-plugin/: OpenCode UI plugin assets + installer flow
• packages/sync-engine/: @mapctx/sync-engine CLI/library for sync
• packages/core/: shared parser/model helpers
• skills/: reusable AI skills for OpenCode/Claude/Cursor
• rules/: agent rules (AGENTS.md, CLAUDE.md, .cursorrules)

Contributor guide: CONTRIBUTING.md

Core capabilities

• Local-first task management in Markdown with deterministic structure
• Task hierarchy support (type, parent, subIssueProgress)
• External detail files for large task descriptions and checklists
• Kanban + roadmap visualization in VS Code
• OpenCode plugin tab for kanban/roadmap workflows
• Sync operations for Issues + Projects v2:
• status, pull, push, bootstrap, reconcile
• dry-run and conflict-oriented workflows

For sync operational details, see packages/sync-engine/README.md and packages/sync-engine/DOCUMENTATION.md.