Compass Bridge

A cross-surface synchronization layer that keeps tasks and session state consistent between Claude Chat, Claude Cowork, and Claude Code. Uses plain markdown files as the shared state -- no database, no MCP server, no external service.

Architecture

Two files in ~/.claude/compass/ form the synchronization layer:

• tasks.md -- Shared task list. Any Claude surface can add, complete, or update tasks.
• state.md -- Session state. Tracks what is being worked on, where, and what is blocking progress.

Create the directory if it does not exist:

mkdir -p ~/.claude/compass

tasks.md Format