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:
setup falls back to the wizard for those.
Flags
Guided Discord setup
On a first run — or any interactivesetup — 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
manualto paste IDs.
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).
Related
- Quickstart — the host bootstrap and first project.
- Commands — the Discord command surface.