Connect your GitHub repository

Install the KanBots GitHub App for your GitHub organization, grant repositories, bind a repo in KanBots, then drive pull requests straight from cards. Product screenshots go on this page soon (placeholder callouts below).

Screenshots coming soon — you'll see the integrations screen and authorize flow.

  1. Install the GitHub App on your org

    In KanBots Cloud, open Settings → Integrations → GitHub and choose Install GitHub App. On GitHub, pick the GitHub organization, then select which repositories KanBots may access (all repos or a curated list).

    [Screenshot placeholder: integrations row]

  2. Authorize the app → choose repos

    Complete GitHub OAuth / installation approval until you're routed back with a success banner. Confirm at least one repo is exposed to KanBots webhooks ("push, PR, checks") so card updates stay synced.

  3. Bind a connected repo

    In your KanBots project, open project settings (or Integration settings depending on the surface) and connect the repo you installed. Specify the default branch that agent runs should use when cloning or opening PRs.

    [Screenshot placeholder: repo bind / default branch picker]

  4. POST /v1/cards/<id>/pr → Open PR from a card

    From any card scoped to this project and repo, use Open PR in the UI (the client calls KanBots REST under the hood, e.g. POST /v1/cards/{id}/pr).

    POST https://api.kanbots.dev/v1/cards/{id}/pr

    The API responds with GitHub identifiers for the pushed branch so reviewers can iterate in GitHub while the card links checks and diff context.

    [Screenshot placeholder: card ribbon + Open PR]