install atom
atom connects your github organization to your slack workspace. setup takes about two minutes and runs entirely from your terminal.
quick start
npx @useatom/cli init
the wizard walks you through four steps:
- sign in with github. your browser opens, you authorize, and the terminal picks up your session automatically.
- install the github app on your organization. atom needs to see pull request activity for the repos you choose.
- install the slack bot in your workspace.
- map your first repo to a channel. pull request threads for that repo will post there.
every step resumes where it left off, so rerunning init after an interruption is safe.
install the cli globally
npm install -g @useatom/cli
atom init
verify your setup
run atom status any time to see the full setup checklist: what is connected, what is configured, and the exact command to fix anything that is not.
setup checklist
✓ github connected (your-org)
✓ slack connected (your workspace)
✓ repos mapped to channels (3)
✓ your slack identity is linked
✓ pr reminders on (#eng-reviews)
○ weekly digest not set (optional: atom reminders set --channel #eng-reviews --digest on)
○ standup not set (optional: atom standup enable --channel #eng-reviews)
the first four are the core setup. reminders, the digest, and standups are optional and can be turned on per channel whenever your team wants them. atom status --json gives the same picture to scripts and agents.
bring your team in
teammates join with an invite code instead of installing anything on github or slack:
atom invite # you: prints the invite code
atom join <code> # them: joins your workspace
each teammate then links their slack identity by running /atom connect inside slack. linking is what makes review requests reach the right person and lets @atom approve act as them on github.
installing with a coding agent
atom is built to be installed by agents. point claude code or any coding agent at this site:
claude "set up atom for my team by following https://useatom.dev/llms-install.md"
the cli is fully non-interactive when it needs to be, every command supports --json, and an mcp server exposes configuration as tools. see the mcp docs for wiring it up.
requirements
- node 18.17 or newer for the cli
- admin access on the github organization (to install the github app)
- permission to add apps to the slack workspace
if you have neither github nor slack admin access, run atom init anyway: it prints an invite link you can hand to the person who does.