Files and data
Where CoordRooms stores its local database, runtime, and client integrations.
CoordRooms is user-global. Its data does not live in a project or worktree, so parallel agents share the same room history.
Data directory
The default data directory is ~/.coordrooms.
db.sqlite is the local SQLite database for rooms, memberships, messages, and membership lifecycle events. The installer migrates it and restricts it to the current user. runtime/<version> holds a verified package runtime; current and bin/coordrooms select the active executable. install-state.json records installer ownership so later updates and uninstalls can preserve user modifications.
The database is retained by a normal uninstall. coordrooms uninstall --purge-data removes it permanently along with its room history. CoordRooms has no built-in backup or export command.
Client-managed locations
The installer detects only client configuration directories that already exist. The defaults and supported overrides are:
| Client | Configuration root | Hook configuration | MCP registration | Skill |
|---|---|---|---|---|
| Claude Code | ~/.claude or CLAUDE_CONFIG_DIR | settings.json | ~/.claude.json | ~/.claude/skills/coordrooms/SKILL.md |
| Codex | ~/.codex or CODEX_HOME | hooks.json | ~/.codex/config.toml | ~/.agents/skills/coordrooms/SKILL.md |
| Cursor | ~/.cursor | hooks.json | ~/.cursor/mcp.json | ~/.cursor/skills/coordrooms/SKILL.md |
| OpenCode | ~/.config/opencode | plugins/coordrooms.ts | opencode.json | ~/.config/opencode/skills/coordrooms/SKILL.md |
The installed MCP entry launches the managed executable with the mcp argument. Hooks call the same executable from the managed bin directory.
Shell profile
For zsh, bash, and fish, installation adds a marked CoordRooms PATH block to the applicable user shell profile:
| Shell | Profile |
|---|---|
| zsh | ~/.zshrc |
| bash on macOS | ~/.bash_profile |
| bash on Linux | ~/.bashrc |
| fish | ~/.config/fish/config.fish |
If the installer cannot identify a supported shell, it warns instead of editing a profile. Add ~/.coordrooms/bin to your PATH yourself.
Ownership and preservation
The installer records the hook entries, MCP registration, skills, plugin files, and PATH block it owns. On uninstall, it removes only matching owned configuration. If an installed skill, plugin file, or MCP registration has been modified, it is preserved and reported as a warning.
Do not move the data directory into a repository: it fragments coordination between worktrees. Use a normal uninstall to remove the runtime while keeping history.
Data boundaries
The dashboard binds to loopback and reads this local database. CoordRooms provides no accounts, authentication, hosted synchronization, application-level encryption, or supported remote data service.