GitHub + Kroy

Connect GitHub once. Use it safely with any AI.

  1. GitHub, where it already is.

    GitHub stays the authoritative record. Nothing moves, and nothing is copied that doesn’t need to be.

  2. GitHub connects to Kroy.

    A GitHub App installed on the repositories you choose, or OAuth for per-user access. Kroy holds the connection.

  3. Your AI connects to Kroy.

    Claude, ChatGPT or another AI connects to Kroy — not to GitHub. It never receives GitHub credentials.

  4. Exactly what is allowed.

    Each GitHub action is a Kroy capability; merge pull request waits for a person by default. Kroy cannot change repository settings, branch protection rules, secrets or organisation membership.

  5. A real request.

    Claude asks for read repository contents. Kroy checks the person, the agent and the policy, calls GitHub, and records the request.

GitHub
Kroy
Claude
Priya Client manager
AUDIT

GitHub capabilities

  • github.repos.read
  • github.issues.read
  • github.pull_requests.read
  • github.issues.create
  • !github.pull_requests.merge
  • Kroy cannot change repository setting…
GitHub
Kroy
Claude
Priya Client manager
AUDIT

GitHub capabilities

  • github.repos.read
  • github.issues.read
  • github.pull_requests.read
  • github.issues.create
  • !github.pull_requests.merge
  • Kroy cannot change repository setting…
GitHub connecting to Kroy, then to an authorised AI. GitHub, where it already is.. GitHub connects to Kroy.. Your AI connects to Kroy.. Exactly what is allowed.. A real request..

Supported resources

  • Repositories and file contents (read)
  • Branches
  • Issues and comments
  • Pull requests and reviews
  • Releases
  • Actions workflow runs (read)

Authentication

A GitHub App installed on the repositories you choose, or OAuth for per-user access. Kroy holds the installation credentials; AI clients never receive GitHub tokens.

Supported actions

CapabilityTypeDefault
github.repos.read
Read repository contents
readPolicy
github.issues.read
Read issues
readPolicy
github.pull_requests.read
Read pull requests
readPolicy
github.issues.create
Create issue
writePolicy
github.issues.comment
Comment on issue or pull request
writePolicy
github.branches.create
Create branch
writePolicy
github.pull_requests.create
Open pull request
writePolicy
github.pull_requests.merge
Merge pull request
writeHuman approval
github.releases.create
Create release
writeHuman approval
github.workflows.dispatch
Run workflow
writeHuman approval

Events

github.pull_request.openedgithub.pull_request.mergedgithub.issue.openedgithub.workflow_run.completed

Overview

Engineering teams increasingly run more than one AI agent: one in the editor, one in the terminal, one reviewing pull requests. Each typically asks for its own GitHub token, and each forgets what the others have done.

Kroy connects to GitHub once. Every authorised agent works through Kroy, which holds the credentials, decides what each agent may do, and keeps a shared record of the work in progress in Kroy State — so the agent that picks up a task knows what the previous one changed and why.

Permissions

Each GitHub action is a Kroy capability. Kroy decides every request against the person, the agent, the delegation between them and the organisation’s policies.

A typical policy lets an agent read code, open issues, create branches and open pull requests. Merging, creating a release and running a workflow require a named person to approve. Policies can be set per repository, so an agent may open pull requests on the documentation site but only read the payments service.

Shared state across agents

When Claude Code finishes a change and Codex is asked to review it, both read the same Kroy State: the task, the branch, the decisions taken and what remains. The review does not start from nothing, and neither agent needs access to the other’s session.

Releases and deployments

Kroy can take part in a release workflow: an agent prepares release notes from merged pull requests, a person approves the release, and Kroy creates it. For websites published with Kroy Publish, a merge or an approved publication can trigger a deploy hook on hosting such as Cloudflare.

Industries

Technology companies and in-house development teams are the obvious fit. Professional firms with small internal tools teams can use the same controls to let AI help with scripts and internal systems without granting it write access to everything.

Security

Kroy holds the GitHub App credentials. Agents receive results, never tokens. Revoking an agent’s Kroy access removes its GitHub access immediately, and every request — including refusals, such as an attempted merge without approval — is recorded with the person, agent and repository involved.

Limitations

  • Kroy cannot change repository settings, branch protection rules, secrets or organisation membership.
  • Branch protection and required reviews in GitHub still apply; Kroy cannot bypass them.
  • Access is limited to the repositories the GitHub App is installed on.
  • Actions are subject to GitHub’s own API rate limits.