Getting started

From signup to your first agent run on a KanBots Cloud workspace.

1. 1. Sign up

   Create a KanBots Cloud account for your organization. You'll use the web app to manage boards, invitations, and billing. Open app.kanbots.dev/signup and complete email verification so you can access the dashboard.

   After sign-up, note your org slug and confirm you can sign in — you'll need dashboard access to connect GitHub and dispatch runs from cards.

2. 2. Install the agent CLI

   The agent CLI runs on your machine, executes tool calls locally, and streams results back to KanBots. Install the latest stable build with the one-liner:

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

   The installer detects your OS and architecture, downloads a signed binary, and places kanbots-agent on your PATH. Alternatively, use Homebrew: brew install kanbots/tap/kanbots-agent.

   For more on the CLI, see /docs/agent-cli.

3. 3. Connect a GitHub repo

   In the KanBots dashboard, install the GitHub App for the organization that owns your code. Grant access to the repositories you want agents to clone and push to.

   Link the default branch and confirm webhooks are delivered — KanBots uses them to keep card state and PR activity in sync. You can tighten the repo list later; at least one repo must be enabled before you dispatch a run.

4. 4. Dispatch your first run

   Create or open a card, assign it to an agent, and choose the CLI-backed runner. Start the run from the board; the agent claims the job, clones the linked repository, and posts tool traces and decisions on the card thread.

   When the run completes, review the diff and artifacts on the card, then promote or open a PR from the run summary. If the agent blocks on a decision, answer the prompt from the same thread to unblock execution.