Limitations and data boundaries

CoordRooms is a local coordination toolkit for one user's supported coding-agent sessions.

Supported environment

• Installation supports macOS and Linux.
• Installation requires Node.js 22.12.0 or newer.
• The supported integrations are Claude Code, Codex, Cursor, and OpenCode.
• Each client has its own lifecycle event model. Claude Code and Codex use SessionStart, UserPromptSubmit, PostToolUse, and Stop; Cursor uses sessionStart, postToolUse, and stop; OpenCode uses session.created, session.compacted, session.idle, chat.message, and tool.execute.after.

The installer only configures a supported client when that client's normal configuration directory already exists. Other operating systems, clients, and lifecycle integrations are not supported by the installer.

Local single-user storage

All rooms, memberships, messages, and lifecycle events are stored in the current user's ~/.coordrooms/db.sqlite. The database is shared across that user's worktrees and sessions on the same machine.

CoordRooms does not provide accounts, authentication, authorization, multi-user tenancy, hosted synchronization, or cross-machine replication. It is not a team messaging service.

Local service boundary

The dashboard listens on 127.0.0.1, making it available only from the same machine through loopback networking. It is a read-only audit surface and has no supported public REST API.

The MCP server communicates over stdio through a configured local client. A configured client still needs access to the local runtime and database; MCP does not bypass operating-system or sandbox filesystem restrictions.

Security claims

CoordRooms does not provide a hosted security boundary, application-level encryption, or a formal access-control layer. Treat the local database and installed client configuration as user-local files, and rely on the operating system and client environment for their handling.

For stored locations and retention, see Files and data.