Install the Kana GitHub App
An owner or admin of your Kanaeru organization does this once:- Open Profile from the user menu (your name at the bottom of the left sidebar) and connect GitHub in its connectors section. Inside a workspace, you can also use Connected Services → Connect a Service in the workspace’s Settings.
- Choose Install Kana GitHub App, or Install on an organization to add a GitHub organization.
- Pick the repositories Kanaeru may use. If you install on an organization you don’t own, an organization owner may need to approve it.
kana connectors install-url prints the install page.
What the app can access
The app subscribes to pull request, review, review comment, review thread, issue comment, check run, and check suite events. Those events wake the agent caring for a pull request.
Link your personal GitHub account
In your Profile, connect Personal GitHub to have commits from your own sessions authored by you, with the agent added as a co-author. This never widens access: agents can still only reach the repositories in your organization’s app installation. You can disconnect it at any time from your profile, or revoke it in GitHub under Settings → Applications.How pull requests flow
- Task pull requests. Each task works on its own branch in its own worktree. When its pipeline finishes, it opens a pull request from the task branch into the outcome branch.
- Pull request care. The agent stays with its pull request. It fixes CI failures and review findings, and passes questions it can’t answer back to you.
- Delivery pull requests. When the last task’s pull request merges, Kanaeru opens one pull request per repository from the outcome branch into your integration branch. The outcome’s explanation is in the description.
- Acceptance. When the delivery pull requests merge, you sign off with Start retrospective and the outcome moves to its retrospective. After the retrospective, Accept delivery and complete outcome completes it.