Kettle

GitHub connection

Let your agents clone, commit, open pull requests and comment in the repositories you choose.

The Kettle GitHub App gives your agents access to the repositories you pick, and nothing else. You never paste a GitHub token anywhere: your kettle gets short-lived access from the app as your agents need it.

Connect

  1. On your Kettle dashboard, find the GitHub section. Choose Add an org to install Kettle Bot on a new organization or your personal account. If it is already installed, choose Link an org where Kettle Bot is already installed, authorize GitHub, then choose the installation to link. You must own a personal installation or be an active admin of its organization.
  2. On GitHub, choose Only select repositories and pick the ones your agents may use. For an existing installation, use Manage repos beside that organization in Kettle to change its selection. You can repeat the connection flow to add more organizations.
  3. Agents that were already running pick up access after you stop and start them from their page on your dashboard.

An installation may be linked to more than one Kettle account. Each linked account's agents can use the repositories granted to that installation. Changes to the repository selection take effect without reconnecting.

What the app can do

The app asks GitHub for these permissions. The first four apply only to the repositories you chose:

PermissionWhy
Contents: read and writeClone, commit and push branches
Pull requests: read and writeOpen and update pull requests
Issues: read and writeRead issues and leave comments
Metadata: readRequired by GitHub for every app
Organization members: readConfirm you're an admin of the org you connect

GitHub's install screen also lists Workflows. Kettle never gives that permission to your agents, so they can't change your GitHub Actions files.

How your agents show up on GitHub

Agents use the ordinary git and gh commands in their container. Kettle fills in the credentials for each command, so there is nothing to log in to.

  • Commits are authored by the Kettle app's bot account, with you added as a co-author through a Co-authored-by line. Merge commits don't get the line.
  • Pull requests and comments come from the bot account too.
  • If you set your own git identity or sign gh in yourself inside the agent's terminal, your settings win.

Access lasts an hour at a time and is renewed automatically while the repository is still granted.

Disconnect

  • Disconnect an account: choose Disconnect next to the account in the GitHub section. Running agents lose access on their next check, usually within a minute.
  • Revoke everywhere: uninstall the Kettle app from your account or organization on GitHub. Any access already handed to an agent expires within the hour.
  • Change which repositories: choose Manage repos beside the organization and edit the list on GitHub.