BadgerClaw CLI

One-click bot provisioning for BadgerClaw.

Install

Prerequisites: Node.js 18+ and npm must already be installed (badgerclaw is a Node CLI installed via npm). On a fresh/bare host, install Node first — e.g. nodesource on Linux or nvm (nvm install 18) — then:

npm install -g badgerclaw

For the Hermes runtime, badgerclaw setup --hermes installs + starts Docker for you (Docker Desktop/colima on macOS, docker.io on Linux), so you don't need to install Docker yourself.

Usage

# Authenticate
badgerclaw login

# Check status
badgerclaw status

# Manage bots
badgerclaw bot create mybot
badgerclaw bot list
badgerclaw bot delete mybot

Development

npm install
npm run build
node dist/index.js --help

Local Backend

Use environment variables to point the CLI at your local API and website instead of production.

# Shorthand — sets both API and auth URL to localhost defaults
BADGERCLAW_ENV=local node dist/index.js login

# Or override URLs individually
BADGERCLAW_API_URL=http://localhost:8000 \
BADGERCLAW_AUTH_URL=http://localhost:5500 \
node dist/index.js login

| Variable | Default (production) | Local value | |---|---|---| | BADGERCLAW_ENV | (unset) | local | | BADGERCLAW_API_URL | https://api.badger.signout.io | http://localhost:8000 | | BADGERCLAW_AUTH_URL | https://badgerclaw.ai | http://localhost:5500 |

Make sure the local API (badgerclaw-api) and website (serve.py --local) are both running before testing.