/ai-implement comment trigger work correctly: the PR is opened by the bot, so subsequent comments on it can be reliably attributed and re-dispatched.
Create the GitHub App
Open the GitHub App creation page
Go to GitHub → Settings → Developer settings → GitHub Apps → New GitHub App.If you want the App to be owned by a GitHub organization rather than your personal account, navigate to your organization’s settings page first, then go to Developer settings → GitHub Apps → New GitHub App.
Name the App and set the homepage URL
Give the App a name such as
ai-implement-bot. The name appears in PR authorship and comment attribution, so choose something your team will recognize.Set the homepage URL to any valid URL — for example, the AI-Implement GitHub repository.Uncheck Webhook active unless you intend to configure webhook delivery separately. AI-Implement polls Linear directly and does not require incoming webhooks from GitHub to function.Set repository permissions
Under Repository permissions, configure the following:
Leave all other permissions at their defaults (no access).
| Permission | Level |
|---|---|
| Contents | Read and write |
| Pull requests | Read and write |
| Issues | Read and write |
| Workflows | Read and write |
Choose where the App can be installed
Under Where can this GitHub App be installed?, select Only on this account if you want to restrict the App to your own organization. Select Any account if you plan to install it across multiple organizations.
Create the App and note the App ID
Click Create GitHub App. On the resulting page, note the App ID — you will need it as
AI_IMPLEMENT_APP_ID (for the workflow secrets) and as GITHUB_APP_ID (for the orchestrator).Generate a private key
Scroll to the Private keys section and click Generate a private key. GitHub downloads a
.pem file to your computer.Keep this file secure. You will paste its contents as the AI_IMPLEMENT_PRIVATE_KEY secret in your target repos and as the GITHUB_APP_PRIVATE_KEY variable in the orchestrator.Install the App on your target repos
Go to the App’s Install App tab and install it on the GitHub organization or personal account that owns your target repositories. You can choose All repositories or restrict to specific repos — install it on at least the repos you intend to connect to AI-Implement.
Add secrets to your target repos
The workflow templates that AI-Implement syncs into target repos read the following secrets. Add them at the organization level (recommended) so all target repos inherit them, or add them individually per repo under Settings → Secrets and variables → Actions.| Secret | Description |
|---|---|
AI_IMPLEMENT_APP_ID | The numeric App ID from the GitHub App page |
AI_IMPLEMENT_PRIVATE_KEY | The full PEM private key content, including the -----BEGIN RSA PRIVATE KEY----- header and footer |
CLAUDE_CODE_OAUTH_TOKEN | Claude Code OAuth token — used in preference to the API key when both are set |
ANTHROPIC_API_KEY | Anthropic API key — used as a fallback when no OAuth token is present |
LINEAR_API_KEY | Linear personal API key — used by the workflow to update issue status and post comments |
CLAUDE_CODE_OAUTH_TOKEN takes precedence over ANTHROPIC_API_KEY when both secrets are set. You only need one Claude authentication method, but having both configured gives you a fallback.Enable pull request creation in target repos
Each target repo must allow GitHub Actions to create and approve pull requests. Without this setting, the workflow will fail when it tries to open the PR. In each target repo, go to Settings → Actions → General and enable Allow GitHub Actions to create and approve pull requests.What’s next
Deploy the orchestrator
Run the orchestrator on Fly.io or locally with the credentials you just created.
Connect a target repo
Sync workflow templates into a repo and map it to a Linear team.