Skip to main content
Celly installs and runs through the bot-celly CLI on the host. It requires Node 24 and the host prerequisites in the Quickstart.

Commands

Updating a single value

Any configuration flag except --home turns setup into a targeted update — only the keys you pass are rewritten in the env file, and the wizard is skipped:
Restart the bot afterwards to apply the change. If the Discord token or guild IDs are still missing, setup falls back to the wizard for those.

Flags

Guided Discord setup

On a first run — or any interactive setup — Celly verifies your bot token against Discord and helps you finish the Discord side without leaving the terminal:
  • Token check. It prints the bot the token belongs to so you can confirm it.
  • Intents. If the Message Content or Server Members intent is off it warns you and prints the exact Developer Portal URL to enable it. Message Content off is the usual reason a bot never comes online.
  • Invite URL. A ready-made invite link carrying the permissions Celly needs (see Discord invite permissions).
  • Guild discovery. It lists the guilds the bot can already see; pick one by number, or type manual to paste IDs.
Everything is best-effort: with no network the wizard falls back to the previous manual token and guild-ID prompts, so setup always completes. bot-celly doctor runs the same checks and reports the bot identity, the intent state, and a bad token (hard failure) versus an unreachable API (advisory).

Configuration and data

The wizard writes ~/.bot-celly/.env (Windows: %USERPROFILE%\.bot-celly\.env) with mode 600 on POSIX hosts; on Windows the file inherits the user-profile ACLs (chmod is a no-op there). Existing values are shown as defaults — press Enter to keep them. On a first run it also asks whether to add a GitHub token for the sandboxes (stored as GITHUB_TOKEN; skip it with n or pass --github-token); when a token already exists the prompt offers keep/update/remove. DATA_DIR defaults to ~/.bot-celly/data; PROJECTS_ROOT still defaults to ~/Celly/projects. Set CELLY_HOME to move the directory, and CELLY_ASCII=1 to force ASCII output symbols even when color is on. See Configuration for every variable.

Exit codes

0 success, 1 an operational failure (missing prerequisite or config), 2 a usage error (unknown command or flag).
  • Quickstart — the host bootstrap and first project.
  • Commands — the Discord command surface.