Installation

bun install -g nucbot

Usage

Initialize a New Project

The init command helps you create a new NucBot project. There are two ways to use it:

1. Interactive mode:

nucbot init

2. Direct mode:

nucbot init --template <template> --name <project-name>

Options:

• -t, --template: Template type (link, link-express)
• -n, --name: Project name
• --login: Include authentication/login functionality

Example:

nucbot init --template link --name nucleoid_app

Watcher — docker-compose redeploy server

Listens for authenticated POSTs on /<service> and runs docker compose pull + up -d for that service.

nucbot watcher --file ./docker-compose.yml --token $NUCBOT_TOKEN

Bridge — Trello ↔ Slack

Opens a Slack thread when a card moves to In Progress, posts the PR link when it moves to In Review, sends staleness warnings and a daily EOD report.

nucbot bridge --setup    # one-time webhook registration
nucbot bridge            # run the bridge

Required env: TRELLO_API_KEY, TRELLO_TOKEN, TRELLO_BOARD_ID, SLACK_BOT_TOKEN, SLACK_CHANNEL_ID. See nucbot --help for all options.

Development

Built with Bun + TypeScript.

bun install
bun run dev init            # run CLI from source
bun run lint                # type-check
bun run build               # cross-platform binaries → dist/
bun run build:local         # local binary → dist/nucbot

License

This project is licensed under the Apache License 2.0 — see the LICENSE file for details.