@nonbot/cli

The local host for non.bot ▶ Run. Install it, log in once, and leave the daemon running — when you click ▶ Run on a story in non.bot, a terminal opens on your machine and starts the work in your linked repo.

npm install -g @nonbot/cli
nonbot login
nonbot daemon

How it works

The daemon runs as an ordinary process in your shell. It polls non.bot for Runs you've started, and when one arrives it opens a terminal in your linked repository and launches your CLI agent (claude, codex, or gemini). Because it's a plain Node process, it uses your existing PATH and whatever CLI logins you already have — no extra setup.

Getting started

# 1. Install
npm install -g @nonbot/cli

# 2. Create a Personal Access Token on non.bot
#    Settings → Connections → API tokens → "New token"

# 3. Log in (paste the token when prompted)
nonbot login

# 4. Leave the daemon running in a terminal tab
nonbot daemon

# 5. Click ▶ Run on non.bot — a terminal opens and starts the work.

Non-interactive login (for CI or scripting):

nonbot login --token "$NONBOT_PAT"

Commands

nonbot login            Log in with a Personal Access Token
nonbot daemon           Run the poll loop and launch terminals (the main command)
nonbot run <id>         Launch a single Run by id, then exit
nonbot status           Show login + daemon status
nonbot doctor           Health check — auth, server, providers, terminal
nonbot logs             Show recent local Run launches
nonbot profiles         List configured accounts
nonbot test             Print a local diagnostic banner (no server needed)
nonbot --help           Full command list
nonbot --version        Print the version

Useful flags

| Flag | Effect | |---|---| | --headless | Run inline without opening a terminal window (daemon, run) | | --profile <name> | Use a named account instead of the default | | daemon --install / --uninstall | Run the daemon automatically at login |

Terminals

On macOS the daemon launches Terminal or iTerm; on Linux it uses your system terminal; on Windows it uses Windows Terminal. If you run the daemon inside a tmux session, Runs open as new tmux windows instead of separate terminal windows.

Override the terminal with NONBOT_TERMINAL (e.g. NONBOT_TERMINAL=iterm), or set a preferred terminal in your non.bot settings.

Configuration

Credentials are stored in ~/.config/nonbot/auth.json (file mode 0600). Override the config directory with NONBOT_CONFIG_DIR.

If a token is lost or compromised, rotate it at non.bot → Settings → Connections → API tokens.

Requirements

• Node.js 18 or newer
• A non.bot account with a linked repository

License

Proprietary — all rights reserved. See LICENSE. This package is published to npm solely to function as the local host for non.bot ▶ Run; it is not open-source software.