CLI + MCP server for Atom — GitHub pull request notifications in Slack, threaded per PR.
npm install -g @useatom/cli atom init
Setting up with a coding agent? Point it at useatom.dev/llms-install.md.
| Command | What it does |
|---|---|
atom init |
Interactive setup: sign in → workspace → connect GitHub + Slack → map a repo. Resumable. |
atom login |
GitHub sign-in via browser. --with-token (env ATOM_TOKEN/stdin) for CI, --manual for SSH. |
atom logout / atom whoami |
Clear / show the session. |
atom status |
Workspace overview: connections, plan, mappings. |
atom connect github|slack |
Run one connection step (opens browser, waits for completion). |
atom map [repo] [channel] |
Map a repo's PRs to a channel. Interactive without args. |
atom unmap [repo] |
Remove a mapping (--yes to skip confirm). |
atom repos / atom channels |
List repos (with mappings) / channels the bot can post to. |
atom reminders [list] |
List PR reminder configs. |
atom reminders set --channel #x |
Create or update reminders (--time, --tz, --days, --repos; repos default to the channel's mappings). |
atom reminders delete --channel #x |
Remove a channel's reminders. |
atom standup status|enable|disable |
Manage the standup (enable --channel #x --nudge 09:30 --post 11:00 --tz Zone --days mon,fri). |
atom standup add-user|remove-user <login> |
Enroll or remove participants (opt-in only). |
atom invite / atom join <code> |
Invite teammates / join a workspace. |
atom mcp |
Run the MCP server on stdio. |
Every command supports --json for scripting; most accept
-w, --workspace <id>.
claude mcp add atom -- atom mcp
# or with no global install:
claude mcp add atom -- npx -y @useatom/cli mcp14 tools: atom_status, list_repos, list_channels, list_mappings,
map_repo, unmap_repo, get_invite_link, list_reminders, set_reminder,
delete_reminder, get_standup, set_standup, add_standup_participant,
remove_standup_participant. Requires atom login first — the server reads
the same ~/.useatom/config.json.
| Variable | Purpose |
|---|---|
ATOM_API_URL |
Override the API base URL (local dev: http://localhost:8500). |
ATOM_TOKEN |
Session token override — used by login --with-token and headless runs. |
ATOM_CONFIG_DIR |
Config directory override (tests/CI). Default ~/.useatom. |
npm install npm run build # tsup → dist/ npm test # vitest: config unit tests + MCP protocol test (needs a build) npm run typecheck