The kanbots-agent CLI

The CLI runs workloads on your machine, streams events back to KanBots Cloud, and pairs with agent runs created from cards in the dashboard.

Install

Run the signed installer script; it detects your OS and architecture and places kanbots-agent on your PATH.

curl -fsSL https://kanbots.dev/install.sh | sh

Login

Start device-flow login in your browser so the CLI mints credentials for org-scoped runs.

kanbots-agent login

Opening https://auth.kanbots.dev/device ...

Complete sign-in in your browser...
Authorized · user you@company.com · org acme}

Daemon

Keep a long-lived process online to poll for dispatched runs and relay tool output.

kanbots-agent daemon

listening on agent-bridge …
connection: authenticated · org acme
idle — waiting for work

Doctor

Validates binary version, clocks, outbound connectivity to the KanBots Agent Bridge, and local permissions.

kanbots-agent doctor

version: kanbots-agent 0.42.3
bridge reachable: OK
credential store writable: OK

Status & logs

Inspect linkage to the dashboard and streaming history for troubleshooting.

kanbots-agent status

kanbots-agent logs

$ kanbots-agent status
org acme · user you@company.com · bridge connected · idle

$ kanbots-agent logs —tail 20
[12:03:41] polled queue — no assignments
[12:04:02] received run_job run_abc…