Skip to main content
Glama

@useatom/cli

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.

Commands

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>.

Related MCP server: GitHub PR Analysis MCP Server

MCP

claude mcp add atom -- atom mcp
# or with no global install:
claude mcp add atom -- npx -y @useatom/cli mcp

14 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.

Environment

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.

Development

npm install
npm run build       # tsup → dist/
npm test            # vitest: config unit tests + MCP protocol test (needs a build)
npm run typecheck

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers