onbonfire-cli
v0.1.0
Published
Bonfire CLI — manage your community from the terminal
Maintainers
Readme
onbonfire-cli
Manage your Bonfire community from the terminal.
Install
# From hosted tarball (works today, no npm registry needed)
npm install -g https://onbonfire.com/cli/onbonfire-cli-0.1.0.tgz
# Or from npm (once published)
npm install -g onbonfire-cliQuick start
bonfire login # Browser-assisted: paste your API key
bonfire whoami # Show your tenant + key context
bonfire channels list # List all channels
bonfire channels create --name announcements --type announcement
bonfire messages post <channel-id> --text "Welcome!"
bonfire members list --role moderatorCommands
| Command | Description |
|---|---|
| bonfire login | Authenticate (interactive or --key bf_live_…) |
| bonfire logout | Clear local credentials (~/.bonfire/config.json) |
| bonfire whoami | Show active tenant, plan, key prefix, scopes |
| bonfire channels list [--space <id>] | List channels (optionally filter by space) |
| bonfire channels create --name <name> [--space-name <space>] [--type text\|announcement\|resource\|event\|voice] | Create a channel |
| bonfire messages list <channelId> [--limit <n>] | List messages |
| bonfire messages post <channelId> --text <text>\|--file <path> [--pinned] | Post a message |
| bonfire members list [--role <role>] [--limit <n>] [--offset <n>] | Paginate members |
Auth
Generate an API key at https://onbonfire.com/admin/api-keys and run bonfire login.
API access requires a Business or Enterprise plan.
Self-hosted
bonfire login --url https://community.example.com/api/v1 --key bf_live_…Or set BONFIRE_API_URL in your environment.
Storage
Credentials live in ~/.bonfire/config.json (mode 0600). Delete the file or run bonfire logout to remove.
Rate limits
- Business: 300 requests/minute per key
- Enterprise: 1000 requests/minute per key
Inspect headers X-RateLimit-Remaining and Retry-After on 429 responses.
Related
- REST API: https://onbonfire.com/docs/api
- MCP server: connect Claude to your community via
https://onbonfire.com/api/mcp
License
MIT
