@eutima/atoll-cli

Command-line client for the Atoll control plane: authenticate, connect or create a GitHub repository, trigger deployments, and inspect status/logs — without leaving your terminal.

Requirements

• Node.js 18 or newer.
• git — atoll init offers to install it for you if it's missing.
• Claude Code (or, on Windows, Claude Desktop) — optional; atoll init offers to install it for you if it's missing.

Quick start

npx @eutima/atoll-cli init

Run from inside (or on top of) the project you want to deploy. It will:

1. Check git is installed (offering to install it if not).
2. Check Claude Code is installed (offering to install it if not — Claude Desktop on Windows, since Claude Code doesn't run natively there).
3. Log you in. New accounts are created on the web: choosing "Create a new account" opens the sign-up page for the free 30-day trial.
4. git init the current directory if needed.
5. Create a GitHub repository (or connect an existing one) if there's no origin remote yet.
6. Make sure the Atoll GitHub App can see the repository.
7. Connect it to Atoll and optionally set up a deployment environment.

Prefer a global install so you can just type atoll:

npm install -g @eutima/atoll-cli
atoll init

Authentication

atoll login opens your browser to sign in (new accounts are created on the web sign-up page), approves the CLI from there, and stores a personal access token in ~/.config/atoll/config.json. Nothing else in the CLI ever touches your password — every other command uses that stored token.

Commands

| Command | Description | | --- | --- | | atoll init | One-command onboarding: git, login (or a link to the web sign-up for a free trial), and connect the current directory's repo. | | atoll login [--api-url <url>] | Authenticate via the browser and store a token. | | atoll logout | Revoke the stored token and forget it locally. | | atoll whoami | Show the currently authenticated user. | | atoll repo list [--search <term>] | List repositories connected to Atoll. | | atoll repo create <name> [--org <account>] [--public] | Create a new GitHub repository and point this directory's git remote at it (private by default). | | atoll setup | Connect (or create) the current directory's repository in Atoll. | | atoll helix [--url <url>] | Add "Login with Helix" to an existing app: installs the Helix Auth skill into .claude/skills/ and shows the next steps (credentials, Variables tab, deploy). | | atoll deploy [branch] [--repo <name>] | Push the current (or given) branch and wait for the deployment to finish. | | atoll status [--repo <name>] [--environment <name>] | Show the latest deployment per environment. | | atoll deployments list [--repo <name>] | List deployments for a repository. | | atoll deployments rollback <deploymentId> | Roll back to the previous successful deployment. | | atoll logs [--repo <name>] [--environment <name>] [--follow] | Read structured pipeline logs, or --follow to live-tail container logs. |

Repo-scoped commands infer the repository from the current directory's git remote (or the sole connected repository, if there's only one) when --repo is omitted.

License

MIT © Eutima