Give agents scoped pull-request tools and configure PR event routing
Use your own GitHub App to let an agent read a pull request or post comments.
Choose its tools independently from incoming events. Answer questions and approvals
in Omnara’s dashboard; GitHub has no interaction handler. The
interactions API is also available.
Connect your GitHub App
Dashboard
Open Integrations in your project and choose GitHub PR review. Keep the
suggested Omnara name github-bot or enter your own, such as reviews. Choose
whether the GitHub App belongs to your personal account or an organization, then
select Continue to GitHub. Choose the App’s public name on GitHub’s registration
page; it is separate from the Omnara integration name. Omnara supplies the webhook,
event subscriptions and required permissions. The registration belongs to you.After registration, Omnara saves the credentials and checks account access automatically.
Select Choose repositories on GitHub to grant access in the same tab; GitHub
returns you to Omnara to continue setup. Omnara selects a single available account
automatically; if several are available, choose which one to connect. Select Connect integration
to finish. If organization approval is pending, return later using the saved
credential and check access again. Nothing launches until you choose an agent
profile in Pull requests and select Save changes.
PR-open launches, mention launches and comments that steer agents require repository
write access. This applies to PRs from forks too; outside contributors cannot start
agents just by opening a PR. Choose a profile whose tools, machine access and secrets are
appropriate for untrusted input, and review its tool permissions before enabling
incoming work.
The new GitHub App is private. To install it outside its owning account, change
its visibility in GitHub App settings. Guided registration supports GitHub.com.
Choose Enter App details for a registration you already own or manual setup.
Complete registration within an hour. If credential conversion or saving fails,
recover the existing App by generating a private key and setting a webhook secret
in GitHub, then enter those values through manual setup. A saved credential remains
available even if the Omnara integration’s settings changed during registration.Guided discovery supports user and organization Apps and installations.
Enterprise-owned Apps and enterprise-level installations report an unsupported
setup instead of prompting repeated retries. Organization installations within
GitHub Enterprise Cloud still use the ordinary organization flow.Manage repository access in GitHub. Optionally restrict the launcher to one
repository in the integration settings. This limits incoming launches; it does
not narrow the installation access granted through Git credentials.
Manual setup
Register a GitHub App
you control. Give it repository Pull requests: Read-only, or Read & write
if agents will comment, resolve threads or open PRs, and Issues: Read-only for incoming PR conversation
comments. For Git credentials or resolving review threads, also request
Contents: Read & write. To show a check on the PR while the agent works, also request
Checks: Read & write. For gh to read CI results, also request at least Read-only for
Actions, Checks and Commit statuses.
Enable webhooks with URL https://YOUR_OMNARA_HOST/api/integrations/github/events
and a webhook secret. Subscribe to the eventspull_request, issue_comment,
pull_request_review and pull_request_review_comment.
Install the App on the repositories you want to use. Record its numeric
App ID, numeric Installation ID, RSA private key
and webhook secret. App ID and Installation ID are different values.
In the dashboard, choose Enter App details, enter these values and connect.
Omnara creates the credential for you, or you can select a saved credential.
Use the displayed webhook URL for your deployment and test delivery after connecting.
The following secret and setup requests are only needed for API setup.
API
Create the integration with
POST /orgs/{orgID}/projects/{projectID}/integrations:
Use its current setup_revision. The credential’s App ID must match
provider_tenant_id; provider_account_ref is the installation ID. Omnara verifies
the app, installation and bot identity before saving. Reconfigure after renaming
the GitHub registration to refresh its bot login. Verified numeric identities
remain fixed. Disconnecting or deleting the Omnara integration requires no GitHub request
and changes no comments or reviews in GitHub.The GitHub App ID header selects candidate credentials; the signature and installation identity authenticate
the event. Verified installation identity routes ordinary events to each
matching active Omnara integration. Independent integrations may use the same installation;
they are not automatically merged. Configure an active integration before testing ping.
Select PR tools
After saving the reviews integration, select operations by qualified tool name:
The GitHub launcher assigns one pull request to the agent. Every tool operates on
that PR, so the model supplies neither repository nor PR identifiers. Adding these
tools to an agent without an assigned PR is insufficient; calls fail before
contacting GitHub. Subscriptions independently control incoming events and do not
assign or change the tools’ PR. Machine Git authentication uses the separate
git_credentials capability described below.read returns PR details by default. Its section can select diff, files,
discussion_comments, review_comments, reviews, review, pending_review or
review_threads.
Comments, files and submitted reviews use page and limit; follow next_page
until it is absent, including after an empty page. reviews includes the overall
review body, state (such as APPROVED, CHANGES_REQUESTED or DISMISSED), author,
commit and submission time. Unpublished pending reviews are excluded.review_threads uses cursor and limit instead of page. Pass the returned
next_cursor to read the next page; an absent cursor means the end. Each thread
includes is_resolved, is_outdated, its path/line and, when available, a
comment_id linking to the first available comment in review_comments or reply.
Read comment bodies and replies with review_comments. Lists default to 30 items
and accept a limit of 1–100. Oversized diff reads fail with guidance to use
files and follow next_page. Individual file patches may be incomplete for large or binary changes.discussion_comment posts a PR conversation comment using body.
review_comment posts on the diff using body, commit_id, path, line and
side (LEFT or RIGHT); provide start_line and start_side together for a
multiline comment. reply uses comment_id and body to reply to an existing
review comment. These publish individual comments.resolve_thread resolves a review thread. Pass the thread’s id from
review_threads as review_thread_id. Already resolved threads are left
unchanged. Resolving requires the App’s
Pull requests: Read & write and Contents: Read & write permissions, which Apps
registered through Omnara have.To build a review incrementally, first use read with section: pending_review.
It returns this bot’s pending review, or null. GitHub allows one pending review
per bot per PR, including when multiple integrations use the same bot.
start_review creates a draft at commit_id and returns its id. Pass that
review_id instead of commit_id to review_comment to add unpublished findings
one at a time. A pending review can prevent immediate inline comments or replies;
continue, publish, or discard the draft before retrying a rejected operation.Use read with section: review and review_id for the review’s summary and state,
and section: review_comments with that ID to page through its comments.
submit_review publishes those findings with body as the summary. It submits a
COMMENT review; it does not approve or request changes. discard_review deletes
only the specified pending review and its unpublished comments. Inspect the draft
before either action. If submission requires approval, its tool call contains the
review ID and summary; the inline findings remain in GitHub.GitHub stores the draft. Stopping or restarting an agent neither publishes nor
deletes it. An uncertain network result requires read-back before repeating the
action: pending_review for draft creation/deletion, review for submission, or
review_comments for a draft comment. Existing agents need the new operations
enabled in their configuration; their saved tool selection does not change automatically.
Git credentials
Agents can use a connected integration for HTTPS Git and GitHub CLI (gh) access on github.com:
This works independently of PR tools, subscriptions and PR assignment. The GitHub
launcher adds its integration automatically; an explicit choice in the selected
profile takes precedence. Subagents do not inherit this capability, including
from their selected profile. Configure machine access separately and run ordinary
Git commands with HTTPS repository URLs.Credentials inherit all repositories granted to the connected installation
unless repository_ids lists a subset; find an ID with gh api repos/OWNER/REPO --jq .id.
They are read-only unless Let agents push code (code_write) is enabled on
the integration and read_only isn’t set. Write credentials can also open, comment on and approve
pull requests. The assigned PR and launcher.repository_id do not narrow
these credentials. Existing PR tools retain their assigned-PR restrictions.
See GitHub’s installation token scope.Apps registered through Omnara get Contents, Pull requests and Checks: Read & write, plus
Actions, Commit statuses and Issues: Read-only. If an App only
has Contents: Read-only, its write credentials fail while Let agents push code is
enabled; grant Read & write in the App’s settings and have the installation
owner approve it. Pushes remain subject to GitHub’s repository rules and can’t
change files under .github/workflows. See GitHub’s permission guidance.Git credentials require an up-to-date omnarad on every machine. Omnara does not
enforce a minimum daemon version for this feature. Older daemons ignore the
credential setting and may use existing machine credentials instead.The helper handles github.com HTTPS authentication in enabled agent processes
and replaces other GitHub HTTPS helpers there. Other processes, hosts and SSH
authentication are unaffected; global Git config is unchanged. To opt out on a
machine, run OMNARA_GIT_CREDENTIALS=0 omnarad install; the installer persists
git_credentials_disabled. Commands requesting Git credentials fail during
preparation on an opted-out machine. This also applies to GitHub-launched agents,
since their launcher adds the capability automatically. gh uses the same credentials, even on
machines with a gh auth login, unless you set GH_TOKEN or GITHUB_TOKEN yourself. gh
commands that read CI results, such as gh pr checks and plain gh pr view, need the App’s
Actions, Checks and Commit statuses access; if the App lacks them, add them in its
settings and have the installation owner approve them.The helper supplies tokens to local workload code; it does not isolate credentials
from other code running as the same OS user. Tokens refresh on use; disconnecting
an integration stops future issuance but does not immediately revoke already
issued tokens or remove cloned files.
Configure incoming PR work
In the dashboard’s Pull requests section, choose one profile and whether to start
agents from PR openings, mentions or both, then select Save changes. These controls
remain editable on the integration page. To mention the bot, use @<app-slug>, such as
@review-helper for https://github.com/apps/review-helper. Use the GitHub App’s slug, not the
Omnara integration name (reviews in these examples).To forward events from one PR to an existing agent, send this body to
POST /orgs/{orgID}/projects/{projectID}/integrations/{integrationID}/subscriptions:
The integration forwards PR conversation comments, inline review comments,
submitted reviews and commits from PR synchronization events. PR-open events only
trigger launches; they are not forwarded through subscriptions. Use Stop forwarding
on the integration page to remove a subscription.For PR-open and mention launches through the API, update the saved integration with
PUT /orgs/{orgID}/projects/{projectID}/integrations/{integrationID}:
The launcher derives the PR tools and Git credentials, adding missing capabilities
and preserving explicit entries from the profile. It attaches a subscription for
the triggering PR. An unrestricted launcher applies to repositories granted to this installation. Set
launcher.repository_id to a numeric repository ID string to narrow it. Use
trigger: "mention" for mention-only launches, or "pull_request_opened" for
PR-open-only launches. With "both", either event can start the PR’s agent;
later mentions reach that same agent. New dashboard setups and the SDK’s
profileIntegrationSetup helper default to both.
GitHub accepts exactly one profile. Updates contain only settings; name and kind are immutable.PR-open launches, comments and reviews require a human sender with repository
write access. PRs opened by bots or outside contributors do not auto-launch;
with mentions enabled, a human with write access can mention the bot to start a review.
Comment and review
checks apply even when the launcher is disabled.
Other comments remain readable as context. Once a PR is subscribed, new commits
continue to reach its agent.Human discussion/review input and new commits steer the agent; only discussion/review
input cancels open interactions. Bot comments, edits and unrelated
issue comments do not become agent input.Omnara adds an 👀 reaction to PR discussion comments and inline review comments
after accepting them for an agent. This means the input was accepted, not that
the agent has finished. Reactions are best effort; a failed reaction does not
prevent the agent from receiving the comment.With the Checks permission, the PR also shows a check named after your GitHub App
and integration, such as my-app (github-bot): Working while the agent, its
subagents or commands they started are running, Waiting for input when it needs
an answer or approval, and Finished when it stops. The check follows work that
GitHub starts: the PR opening, new commits and comments the agent receives. Follow-ups
sent only through Omnara (the dashboard or API) may not update a finished check. Like
reactions, check updates are best effort.GitHub does not automatically retry failed webhook deliveries. If Omnara cannot
persist an event and returns a non-2xx response, explicitly
redeliver it from GitHub
after recovery, manually or through GitHub’s API. Once a receipt is accepted,
Omnara retries processing failures through its internal inbox. Once a receipt has
failed permanently, redelivering the same event does not reset its retry budget;
send a fresh comment or mention instead.For an active configured installation, Omnara commits eligible signed callbacks
before returning HTTP 204. A persistence failure returns 503; it does not schedule
a GitHub retry. Manual redelivery with the same delivery ID is accepted once and
deduplicated while that receipt remains stored. Signed pings and callbacks for
unmanaged or disconnected installations, along with irrelevant events, can receive
204 without creating agent work.
Omnara does not run an automatic GitHub redelivery scheduler.Completed and failed raw receipts are eligible for cleanup seven days after
finishing. Their transport deduplication window ends when they are deleted; agent
conversation history is preserved.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Omnara","colors":{"primary":"#4372cf","light":"#81a1df","dark":"#3162c2"},"logo":{"light":"https://mintcdn.com/omnara/n37k7gqYv1cBmVaT/logo/omnara-logo.svg?fit=max\u0026auto=format\u0026n=n37k7gqYv1cBmVaT\u0026q=85\u0026s=5daf8948f5a1eea8bcd0ee573f967d93","dark":"https://mintcdn.com/omnara/n37k7gqYv1cBmVaT/logo/omnara-logo.svg?fit=max\u0026auto=format\u0026n=n37k7gqYv1cBmVaT\u0026q=85\u0026s=5daf8948f5a1eea8bcd0ee573f967d93"},"favicon":"https://mintcdn.com/omnara/kLEoXaNFboi20nkD/favicon.ico?fit=max\u0026auto=format\u0026n=kLEoXaNFboi20nkD\u0026q=85\u0026s=17264def932025239855552d5c977340","appearance":{"default":"dark","strict":true},"background":{"decoration":"gradient","color":{"dark":"#0b0b0c"}},"navbar":{"links":[{"href":"/support","label":"Support"},{"href":"https://github.com/omnara-ai/omnara","label":"GitHub"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.omnara.com"}},"footer":{"socials":{"x":"https://twitter.com/omnaraai","linkedin":"https://linkedin.com/company/omnara","discord":"https://discord.gg/Dc46sYk6e3"}},"seo":{"metatags":{"canonical":"https://docs.omnara.com","og:site_name":"Omnara Docs","twitter:card":"summary_large_image"}},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter","weight":400}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Discord","icon":"discord","href":"https://discord.gg/Dc46sYk6e3"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"omnara","hasAudioNarration":false,"actualSubdomain":"omnara","customDomains":["docs.omnara.com"],"gitSource":{"type":"github","owner":"omnara-ai","repo":"omnara","deployBranch":"docs-production","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6affa9259cb9ecf566203d32","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":189},{"language":"default","tag":"Endpoints","count":183},{"language":"default","tag":"Documentation","count":55},{"language":"default","tag":"Machines","count":30},{"language":"default","tag":"Integrations","count":22},{"language":"default","tag":"Agents","count":21},{"language":"default","tag":"Configs and Profiles","count":20},{"language":"default","tag":"Organizations and Projects","count":20},{"language":"default","tag":"Examples","count":16},{"language":"default","tag":"Models","count":16}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"img[src*=\"/logo/providers/\"]{object-position:-9999px 0;-webkit-mask:var(--provider-logo) center / contain no-repeat;mask:var(--provider-logo) center / contain no-repeat}.dark img[src*=\"/logo/providers/\"]{background-color:rgb(var(--gray-500))}.dark a[aria-current=\"page\"] img[src*=\"/logo/providers/\"]{background-color:rgb(var(--primary-light))}img[src*=\"/logo/providers/agent37.\"]{--provider-logo: url(\"/logo/providers/agent37.svg\")}img[src*=\"/logo/providers/arker.\"]{--provider-logo: url(\"/logo/providers/arker.svg\")}img[src*=\"/logo/providers/blaxel.\"]{--provider-logo: url(\"/logo/providers/blaxel.svg\")}img[src*=\"/logo/providers/boxd.\"]{--provider-logo: url(\"/logo/providers/boxd.svg\")}img[src*=\"/logo/providers/createos.\"]{--provider-logo: url(\"/logo/providers/createos.svg\")}img[src*=\"/logo/providers/daytona.\"]{--provider-logo: url(\"/logo/providers/daytona.svg\")}img[src*=\"/logo/providers/e2b.\"]{--provider-logo: url(\"/logo/providers/e2b.svg\")}img[src*=\"/logo/providers/freestyle.\"]{--provider-logo: url(\"/logo/providers/freestyle.svg\")}img[src*=\"/logo/providers/modal.\"]{--provider-logo: url(\"/logo/providers/modal.svg\")}img[src*=\"/logo/providers/superserve.\"]{--provider-logo: url(\"/logo/providers/superserve.svg\")}img[src*=\"/logo/providers/tenki.\"]{--provider-logo: url(\"/logo/providers/tenki.png\")}img[src*=\"/logo/providers/unikraft.\"]{--provider-logo: url(\"/logo/providers/unikraft.png\")}"}]}
{"page":{"pagePath":"integrations/github","slug":"/integrations/github","pageMetadata":{"title":"GitHub","description":"Give agents scoped pull-request tools and configure PR event routing","icon":"github","href":"/integrations/github"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Give agents scoped pull-request tools and configure PR event routing\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use your own GitHub App to let an agent read a pull request or post comments.\nChoose its tools independently from incoming events. Answer questions and approvals\nin Omnara’s dashboard; GitHub has no interaction handler. The\n`,_jsx(_components.a,{href:`/events/interactions`,children:`interactions API`}),` is also available.`]}),`\n`,_jsx(Heading,{level:`2`,id:`connect-your-github-app`,children:`Connect your GitHub App`}),`\n`,_jsx(Heading,{level:`3`,id:`dashboard`,children:`Dashboard`}),`\n`,_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Integrations`}),` in your project and choose `,_jsx(_components.strong,{children:`GitHub PR review`}),`. Keep the\nsuggested Omnara name `,_jsx(_components.code,{children:`github-bot`}),` or enter your own, such as `,_jsx(_components.code,{children:`reviews`}),`. Choose\nwhether the GitHub App belongs to your personal account or an organization, then\nselect `,_jsx(_components.strong,{children:`Continue to GitHub`}),`. Choose the App’s public name on GitHub’s registration\npage; it is separate from the Omnara integration name. Omnara supplies the webhook,\nevent subscriptions and required permissions. The registration belongs to you.`]}),`\n`,_jsxs(_components.p,{children:[`After registration, Omnara saves the credentials and checks account access automatically.\nSelect `,_jsx(_components.strong,{children:`Choose repositories on GitHub`}),` to grant access in the same tab; GitHub\nreturns you to Omnara to continue setup. Omnara selects a single available account\nautomatically; if several are available, choose which one to connect. Select `,_jsx(_components.strong,{children:`Connect integration`}),`\nto finish. If organization approval is pending, return later using the saved\ncredential and check access again. Nothing launches until you choose an agent\nprofile in `,_jsx(_components.strong,{children:`Pull requests`}),` and select `,_jsx(_components.strong,{children:`Save changes`}),`.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`PR-open launches, mention launches and comments that steer agents require repository\nwrite access. This applies to PRs from forks too; outside contributors cannot start\nagents just by opening a PR. Choose a profile whose tools, machine access and secrets are\nappropriate for untrusted input, and review its tool permissions before enabling\nincoming work.`})}),`\n`,_jsxs(_components.p,{children:[`The new GitHub App is private. To install it outside its owning account, change\nits visibility in GitHub App settings. Guided registration supports GitHub.com.\nChoose `,_jsx(_components.strong,{children:`Enter App details`}),` for a registration you already own or manual setup.\nComplete registration within an hour. If credential conversion or saving fails,\nrecover the existing App by generating a private key and setting a webhook secret\nin GitHub, then enter those values through manual setup. A saved credential remains\navailable even if the Omnara integration’s settings changed during registration.`]}),`\n`,_jsx(_components.p,{children:`Guided discovery supports user and organization Apps and installations.\nEnterprise-owned Apps and enterprise-level installations report an unsupported\nsetup instead of prompting repeated retries. Organization installations within\nGitHub Enterprise Cloud still use the ordinary organization flow.`}),`\n`,_jsxs(_components.p,{children:[`Manage repository access in GitHub. Optionally restrict the launcher to one\nrepository in the integration settings. This limits incoming launches; it does\nnot narrow the installation access granted through `,_jsx(_components.a,{href:`#git-credentials`,children:`Git credentials`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`manual-setup`,children:`Manual setup`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`https://docs.github.com/en/apps/creating-github-apps/registering-a-github-app/registering-a-github-app`,children:`Register a GitHub App`}),`\nyou control. Give it repository `,_jsx(_components.strong,{children:`Pull requests: Read-only`}),`, or `,_jsx(_components.strong,{children:`Read \u0026 write`}),`\nif agents will comment, resolve threads or open PRs, and `,_jsx(_components.strong,{children:`Issues: Read-only`}),` for incoming PR conversation\ncomments. For Git credentials or resolving review threads, also request\n`,_jsx(_components.strong,{children:`Contents: Read \u0026 write`}),`. To show a check on the PR while the agent works, also request\n`,_jsx(_components.strong,{children:`Checks: Read \u0026 write`}),`. For `,_jsx(_components.code,{children:`gh`}),` to read CI results, also request at least `,_jsx(_components.strong,{children:`Read-only`}),` for\n`,_jsx(_components.strong,{children:`Actions`}),`, `,_jsx(_components.strong,{children:`Checks`}),` and `,_jsx(_components.strong,{children:`Commit statuses`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Enable webhooks with URL `,_jsx(_components.code,{children:`https://YOUR_OMNARA_HOST/api/integrations/github/events`}),`\nand a webhook secret. Subscribe to the `,_jsx(_components.a,{href:`https://docs.github.com/en/webhooks/webhook-events-and-payloads`,children:`events`}),`\n`,_jsx(_components.code,{children:`pull_request`}),`, `,_jsx(_components.code,{children:`issue_comment`}),`,\n`,_jsx(_components.code,{children:`pull_request_review`}),` and `,_jsx(_components.code,{children:`pull_request_review_comment`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Install the App on the repositories you want to use. Record its numeric\n`,_jsx(_components.strong,{children:`App ID`}),`, numeric `,_jsx(_components.strong,{children:`Installation ID`}),`, RSA private key\nand webhook secret. App ID and Installation ID are different values.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`In the dashboard, choose `,_jsx(_components.strong,{children:`Enter App details`}),`, enter these values and connect.\nOmnara creates the credential for you, or you can select a saved credential.\nUse the displayed webhook URL for your deployment and test delivery after connecting.\nThe following secret and setup requests are only needed for API setup.`]}),`\n`,_jsx(Heading,{level:`3`,id:`api`,children:`API`}),`\n`,_jsxs(_components.p,{children:[`Create the integration with\n`,_jsx(_components.code,{children:`POST /orgs/{orgID}/projects/{projectID}/integrations`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"reviews\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"integration_kind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"github_pr\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"settings\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:{}}`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/organization/secrets#create-a-secret`,children:`Create a secret`}),` available to the\nOmnara project, with this `,_jsx(_components.code,{children:`material`}),` shape:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"kind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"github_app_credentials\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"app_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12345\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"private_key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"-----BEGIN RSA PRIVATE KEY-----`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\n`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`...`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\n`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`-----END RSA PRIVATE KEY-----\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"webhook_secret\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"your-webhook-secret\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Configure the returned integration at\n`,_jsx(_components.code,{children:`POST /orgs/{orgID}/projects/{projectID}/integrations/{integrationID}/setup`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"expected_setup_revision\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"provider_tenant_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12345\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"provider_account_ref\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"67890\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"credential_secret_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sec_aeaqcaibaeaqcaibaeaqcaibae\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Use its current `,_jsx(_components.code,{children:`setup_revision`}),`. The credential’s App ID must match\n`,_jsx(_components.code,{children:`provider_tenant_id`}),`; `,_jsx(_components.code,{children:`provider_account_ref`}),` is the installation ID. Omnara verifies\nthe app, installation and bot identity before saving. Reconfigure after renaming\nthe GitHub registration to refresh its bot login. Verified numeric identities\nremain fixed. Disconnecting or deleting the Omnara integration requires no GitHub request\nand changes no comments or reviews in GitHub.`]}),`\n`,_jsx(_components.p,{children:`The GitHub App ID header selects candidate credentials; the signature and installation identity authenticate\nthe event. Verified installation identity routes ordinary events to each\nmatching active Omnara integration. Independent integrations may use the same installation;\nthey are not automatically merged. Configure an active integration before testing ping.`}),`\n`,_jsx(Heading,{level:`2`,id:`select-pr-tools`,children:`Select PR tools`}),`\n`,_jsxs(_components.p,{children:[`After saving the `,_jsx(_components.code,{children:`reviews`}),` integration, select operations by qualified tool name:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`15`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`15`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`tools`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` int__reviews__read`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` int__reviews__discussion_comment`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` permission`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`mode`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`always_ask`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` int__reviews__review_comment`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` permission`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`mode`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`always_ask`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` int__reviews__reply`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` permission`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`mode`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`always_ask`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` int__reviews__start_review`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` int__reviews__submit_review`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` permission`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`mode`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`always_ask`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` int__reviews__discard_review`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` permission`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`mode`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`always_ask`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` int__reviews__resolve_thread`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` permission`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`mode`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`always_ask`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The GitHub launcher assigns one pull request to the agent. Every tool operates on\nthat PR, so the model supplies neither repository nor PR identifiers. Adding these\ntools to an agent without an assigned PR is insufficient; calls fail before\ncontacting GitHub. Subscriptions independently control incoming events and do not\nassign or change the tools’ PR. Machine Git authentication uses the separate\n`,_jsx(_components.code,{children:`git_credentials`}),` capability described below.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`read`}),` returns PR details by default. Its `,_jsx(_components.code,{children:`section`}),` can select `,_jsx(_components.code,{children:`diff`}),`, `,_jsx(_components.code,{children:`files`}),`,\n`,_jsx(_components.code,{children:`discussion_comments`}),`, `,_jsx(_components.code,{children:`review_comments`}),`, `,_jsx(_components.code,{children:`reviews`}),`, `,_jsx(_components.code,{children:`review`}),`, `,_jsx(_components.code,{children:`pending_review`}),` or\n`,_jsx(_components.code,{children:`review_threads`}),`.\nComments, files and submitted `,_jsx(_components.code,{children:`reviews`}),` use `,_jsx(_components.code,{children:`page`}),` and `,_jsx(_components.code,{children:`limit`}),`; follow `,_jsx(_components.code,{children:`next_page`}),`\nuntil it is absent, including after an empty page. `,_jsx(_components.code,{children:`reviews`}),` includes the overall\nreview body, state (such as `,_jsx(_components.code,{children:`APPROVED`}),`, `,_jsx(_components.code,{children:`CHANGES_REQUESTED`}),` or `,_jsx(_components.code,{children:`DISMISSED`}),`), author,\ncommit and submission time. Unpublished pending reviews are excluded.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`review_threads`}),` uses `,_jsx(_components.code,{children:`cursor`}),` and `,_jsx(_components.code,{children:`limit`}),` instead of `,_jsx(_components.code,{children:`page`}),`. Pass the returned\n`,_jsx(_components.code,{children:`next_cursor`}),` to read the next page; an absent cursor means the end. Each thread\nincludes `,_jsx(_components.code,{children:`is_resolved`}),`, `,_jsx(_components.code,{children:`is_outdated`}),`, its path/line and, when available, a\n`,_jsx(_components.code,{children:`comment_id`}),` linking to the first available comment in `,_jsx(_components.code,{children:`review_comments`}),` or `,_jsx(_components.code,{children:`reply`}),`.\nRead comment bodies and replies with `,_jsx(_components.code,{children:`review_comments`}),`. Lists default to 30 items\nand accept a `,_jsx(_components.code,{children:`limit`}),` of 1–100. Oversized `,_jsx(_components.code,{children:`diff`}),` reads fail with guidance to use\n`,_jsx(_components.code,{children:`files`}),` and follow `,_jsx(_components.code,{children:`next_page`}),`. Individual file patches may be incomplete for large or binary changes.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`discussion_comment`}),` posts a PR conversation comment using `,_jsx(_components.code,{children:`body`}),`.\n`,_jsx(_components.code,{children:`review_comment`}),` posts on the diff using `,_jsx(_components.code,{children:`body`}),`, `,_jsx(_components.code,{children:`commit_id`}),`, `,_jsx(_components.code,{children:`path`}),`, `,_jsx(_components.code,{children:`line`}),` and\n`,_jsx(_components.code,{children:`side`}),` (`,_jsx(_components.code,{children:`LEFT`}),` or `,_jsx(_components.code,{children:`RIGHT`}),`); provide `,_jsx(_components.code,{children:`start_line`}),` and `,_jsx(_components.code,{children:`start_side`}),` together for a\nmultiline comment. `,_jsx(_components.code,{children:`reply`}),` uses `,_jsx(_components.code,{children:`comment_id`}),` and `,_jsx(_components.code,{children:`body`}),` to reply to an existing\nreview comment. These publish individual comments.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`resolve_thread`}),` resolves a review thread. Pass the thread’s `,_jsx(_components.code,{children:`id`}),` from\n`,_jsx(_components.code,{children:`review_threads`}),` as `,_jsx(_components.code,{children:`review_thread_id`}),`. Already resolved threads are left\nunchanged. Resolving requires the App’s\n`,_jsx(_components.strong,{children:`Pull requests: Read \u0026 write`}),` and `,_jsx(_components.strong,{children:`Contents: Read \u0026 write`}),` permissions, which Apps\nregistered through Omnara have.`]}),`\n`,_jsxs(_components.p,{children:[`To build a review incrementally, first use `,_jsx(_components.code,{children:`read`}),` with `,_jsx(_components.code,{children:`section: pending_review`}),`.\nIt returns this bot’s pending review, or `,_jsx(_components.code,{children:`null`}),`. GitHub allows one pending review\nper bot per PR, including when multiple integrations use the same bot.\n`,_jsx(_components.code,{children:`start_review`}),` creates a draft at `,_jsx(_components.code,{children:`commit_id`}),` and returns its `,_jsx(_components.code,{children:`id`}),`. Pass that\n`,_jsx(_components.code,{children:`review_id`}),` instead of `,_jsx(_components.code,{children:`commit_id`}),` to `,_jsx(_components.code,{children:`review_comment`}),` to add unpublished findings\none at a time. A pending review can prevent immediate inline comments or replies;\ncontinue, publish, or discard the draft before retrying a rejected operation.`]}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`read`}),` with `,_jsx(_components.code,{children:`section: review`}),` and `,_jsx(_components.code,{children:`review_id`}),` for the review’s summary and state,\nand `,_jsx(_components.code,{children:`section: review_comments`}),` with that ID to page through its comments.\n`,_jsx(_components.code,{children:`submit_review`}),` publishes those findings with `,_jsx(_components.code,{children:`body`}),` as the summary. It submits a\nCOMMENT review; it does not approve or request changes. `,_jsx(_components.code,{children:`discard_review`}),` deletes\nonly the specified pending review and its unpublished comments. Inspect the draft\nbefore either action. If submission requires approval, its tool call contains the\nreview ID and summary; the inline findings remain in GitHub.`]}),`\n`,_jsxs(_components.p,{children:[`GitHub stores the draft. Stopping or restarting an agent neither publishes nor\ndeletes it. An uncertain network result requires read-back before repeating the\naction: `,_jsx(_components.code,{children:`pending_review`}),` for draft creation/deletion, `,_jsx(_components.code,{children:`review`}),` for submission, or\n`,_jsx(_components.code,{children:`review_comments`}),` for a draft comment. Existing agents need the new operations\nenabled in their configuration; their saved tool selection does not change automatically.`]}),`\n`,_jsx(Heading,{level:`2`,id:`git-credentials`,children:`Git credentials`}),`\n`,_jsxs(_components.p,{children:[`Agents can use a connected integration for HTTPS Git and GitHub CLI (`,_jsx(_components.code,{children:`gh`}),`) access on `,_jsx(_components.code,{children:`github.com`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`git_credentials`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` integration`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`reviews`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` repository_ids`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`123456789`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`] `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# optional`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` read_only`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # optional`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`This works independently of PR tools, subscriptions and PR assignment. The GitHub\nlauncher adds its integration automatically; an explicit choice in the selected\nprofile takes precedence. Subagents do not inherit this capability, including\nfrom their selected profile. Configure machine access separately and run ordinary\nGit commands with HTTPS repository URLs.`}),`\n`,_jsxs(_components.p,{children:[`Credentials inherit `,_jsx(_components.strong,{children:`all repositories granted to the connected installation`}),`\nunless `,_jsx(_components.code,{children:`repository_ids`}),` lists a subset; find an ID with `,_jsx(_components.code,{children:`gh api repos/OWNER/REPO --jq .id`}),`.\nThey are read-only unless `,_jsx(_components.strong,{children:`Let agents push code`}),` (`,_jsx(_components.code,{children:`code_write`}),`) is enabled on\nthe integration and `,_jsx(_components.code,{children:`read_only`}),` isn’t set. Write credentials can also open, comment on and approve\npull requests. The assigned PR and `,_jsx(_components.code,{children:`launcher.repository_id`}),` do not narrow\nthese credentials. Existing PR tools retain their assigned-PR restrictions.\nSee GitHub’s `,_jsx(_components.a,{href:`https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app`,children:`installation token scope`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Apps registered through Omnara get `,_jsx(_components.strong,{children:`Contents`}),`, `,_jsx(_components.strong,{children:`Pull requests`}),` and `,_jsx(_components.strong,{children:`Checks: Read \u0026 write`}),`, plus\n`,_jsx(_components.strong,{children:`Actions`}),`, `,_jsx(_components.strong,{children:`Commit statuses`}),` and `,_jsx(_components.strong,{children:`Issues: Read-only`}),`. If an App only\nhas `,_jsx(_components.strong,{children:`Contents: Read-only`}),`, its write credentials fail while `,_jsx(_components.strong,{children:`Let agents push code`}),` is\nenabled; grant `,_jsx(_components.strong,{children:`Read \u0026 write`}),` in the App’s settings and have the installation\nowner approve it. Pushes remain subject to GitHub’s repository rules and can’t\nchange files under `,_jsx(_components.code,{children:`.github/workflows`}),`. See GitHub’s `,_jsx(_components.a,{href:`https://docs.github.com/en/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app`,children:`permission guidance`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Git credentials require an up-to-date `,_jsx(_components.code,{children:`omnarad`}),` on every machine. Omnara does not\nenforce a minimum daemon version for this feature. Older daemons ignore the\ncredential setting and may use existing machine credentials instead.`]}),`\n`,_jsxs(_components.p,{children:[`The helper handles `,_jsx(_components.code,{children:`github.com`}),` HTTPS authentication in enabled agent processes\nand replaces other GitHub HTTPS helpers there. Other processes, hosts and SSH\nauthentication are unaffected; global Git config is unchanged. To opt out on a\nmachine, run `,_jsx(_components.code,{children:`OMNARA_GIT_CREDENTIALS=0 omnarad install`}),`; the installer persists\n`,_jsx(_components.code,{children:`git_credentials_disabled`}),`. Commands requesting Git credentials fail during\npreparation on an opted-out machine. This also applies to GitHub-launched agents,\nsince their launcher adds the capability automatically. `,_jsx(_components.code,{children:`gh`}),` uses the same credentials, even on\nmachines with a `,_jsx(_components.code,{children:`gh auth login`}),`, unless you set `,_jsx(_components.code,{children:`GH_TOKEN`}),` or `,_jsx(_components.code,{children:`GITHUB_TOKEN`}),` yourself. `,_jsx(_components.code,{children:`gh`}),`\ncommands that read CI results, such as `,_jsx(_components.code,{children:`gh pr checks`}),` and plain `,_jsx(_components.code,{children:`gh pr view`}),`, need the App’s\n`,_jsx(_components.strong,{children:`Actions`}),`, `,_jsx(_components.strong,{children:`Checks`}),` and `,_jsx(_components.strong,{children:`Commit statuses`}),` access; if the App lacks them, add them in its\nsettings and have the installation owner approve them.`]}),`\n`,_jsx(_components.p,{children:`The helper supplies tokens to local workload code; it does not isolate credentials\nfrom other code running as the same OS user. Tokens refresh on use; disconnecting\nan integration stops future issuance but does not immediately revoke already\nissued tokens or remove cloned files.`}),`\n`,_jsx(Heading,{level:`2`,id:`configure-incoming-pr-work`,children:`Configure incoming PR work`}),`\n`,_jsxs(_components.p,{children:[`In the dashboard’s `,_jsx(_components.strong,{children:`Pull requests`}),` section, choose one profile and whether to start\nagents from PR openings, mentions or both, then select `,_jsx(_components.strong,{children:`Save changes`}),`. These controls\nremain editable on the integration page. To mention the bot, use `,_jsx(_components.code,{children:`@\u003capp-slug>`}),`, such as\n`,_jsx(_components.code,{children:`@review-helper`}),` for `,_jsx(_components.code,{children:`https://github.com/apps/review-helper`}),`. Use the GitHub App’s slug, not the\nOmnara integration name (`,_jsx(_components.code,{children:`reviews`}),` in these examples).`]}),`\n`,_jsxs(_components.p,{children:[`To forward events from one PR to an existing agent, send this body to\n`,_jsx(_components.code,{children:`POST /orgs/{orgID}/projects/{projectID}/integrations/{integrationID}/subscriptions`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agent_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"YOUR_AGENT_ID\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"conversation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"repository_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`123456`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"pull_request\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`42`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The integration forwards PR conversation comments, inline review comments,\nsubmitted reviews and commits from PR synchronization events. PR-open events only\ntrigger launches; they are not forwarded through subscriptions. Use `,_jsx(_components.strong,{children:`Stop forwarding`}),`\non the integration page to remove a subscription.`]}),`\n`,_jsxs(_components.p,{children:[`For PR-open and mention launches through the API, update the saved integration with\n`,_jsx(_components.code,{children:`PUT /orgs/{orgID}/projects/{projectID}/integrations/{integrationID}`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"settings\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"launcher\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"trigger\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"both\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"profile\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"aprf_aeaqcaibaeaqcaibaeaqcaibae\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The launcher derives the PR tools and Git credentials, adding missing capabilities\nand preserving explicit entries from the profile. It attaches a subscription for\nthe triggering PR. An unrestricted launcher applies to repositories granted to this installation. Set\n`,_jsx(_components.code,{children:`launcher.repository_id`}),` to a numeric repository ID string to narrow it. Use\n`,_jsx(_components.code,{children:`trigger: \"mention\"`}),` for mention-only launches, or `,_jsx(_components.code,{children:`\"pull_request_opened\"`}),` for\nPR-open-only launches. With `,_jsx(_components.code,{children:`\"both\"`}),`, either event can start the PR’s agent;\nlater mentions reach that same agent. New dashboard setups and the SDK’s\n`,_jsx(_components.code,{children:`profileIntegrationSetup`}),` helper default to both.\nGitHub accepts exactly one profile. Updates contain only `,_jsx(_components.code,{children:`settings`}),`; name and kind are immutable.`]}),`\n`,_jsx(_components.p,{children:`PR-open launches, comments and reviews require a human sender with repository\nwrite access. PRs opened by bots or outside contributors do not auto-launch;\nwith mentions enabled, a human with write access can mention the bot to start a review.\nComment and review\nchecks apply even when the launcher is disabled.\nOther comments remain readable as context. Once a PR is subscribed, new commits\ncontinue to reach its agent.`}),`\n`,_jsx(_components.p,{children:`Human discussion/review input and new commits steer the agent; only discussion/review\ninput cancels open interactions. Bot comments, edits and unrelated\nissue comments do not become agent input.`}),`\n`,_jsx(_components.p,{children:`Omnara adds an 👀 reaction to PR discussion comments and inline review comments\nafter accepting them for an agent. This means the input was accepted, not that\nthe agent has finished. Reactions are best effort; a failed reaction does not\nprevent the agent from receiving the comment.`}),`\n`,_jsxs(_components.p,{children:[`With the `,_jsx(_components.strong,{children:`Checks`}),` permission, the PR also shows a check named after your GitHub App\nand integration, such as `,_jsx(_components.code,{children:`my-app (github-bot)`}),`: `,_jsx(_components.strong,{children:`Working`}),` while the agent, its\nsubagents or commands they started are running, `,_jsx(_components.strong,{children:`Waiting for input`}),` when it needs\nan answer or approval, and `,_jsx(_components.strong,{children:`Finished`}),` when it stops. The check follows work that\nGitHub starts: the PR opening, new commits and comments the agent receives. Follow-ups\nsent only through Omnara (the dashboard or API) may not update a finished check. Like\nreactions, check updates are best effort.`]}),`\n`,_jsxs(_components.p,{children:[`GitHub does not automatically retry failed webhook deliveries. If Omnara cannot\npersist an event and returns a non-2xx response, explicitly\n`,_jsx(_components.a,{href:`https://docs.github.com/en/webhooks/using-webhooks/handling-failed-webhook-deliveries`,children:`redeliver it from GitHub`}),`\nafter recovery, manually or through GitHub’s API. Once a receipt is accepted,\nOmnara retries processing failures through its internal inbox. Once a receipt has\nfailed permanently, redelivering the same event does not reset its retry budget;\nsend a fresh comment or mention instead.`]}),`\n`,_jsx(_components.p,{children:`For an active configured installation, Omnara commits eligible signed callbacks\nbefore returning HTTP 204. A persistence failure returns 503; it does not schedule\na GitHub retry. Manual redelivery with the same delivery ID is accepted once and\ndeduplicated while that receipt remains stored. Signed pings and callbacks for\nunmanaged or disconnected installations, along with irrelevant events, can receive\n204 without creating agent work.\nOmnara does not run an automatic GitHub redelivery scheduler.`}),`\n`,_jsx(_components.p,{children:`Completed and failed raw receipts are eligible for cleanup seven days after\nfinishing. Their transport deduplication window ends when they are deleted; agent\nconversation history is preserved.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"GitHub","description":"Give agents scoped pull-request tools and configure PR event routing","icon":"github","href":"/integrations/github"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Connect your GitHub App","slug":"connect-your-github-app","depth":2,"children":[{"title":"Dashboard","slug":"dashboard","depth":3,"children":[]},{"title":"Manual setup","slug":"manual-setup","depth":3,"children":[]},{"title":"API","slug":"api","depth":3,"children":[]}]},{"title":"Select PR tools","slug":"select-pr-tools","depth":2,"children":[]},{"title":"Git credentials","slug":"git-credentials","depth":2,"children":[]},{"title":"Configure incoming PR work","slug":"configure-incoming-pr-work","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"omnara","siteName":"Omnara","title":"GitHub - Omnara","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T23:03:42.561Z","originalFileLocation":"integrations/github.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Give agents scoped pull-request tools and configure PR event routing\">\u003cmeta data-mint-head name=\"application-name\" content=\"Omnara\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/omnara/4SAu5j-ZzC-39B56/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/omnara/4SAu5j-ZzC-39B56/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/omnara/4SAu5j-ZzC-39B56/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/omnara/4SAu5j-ZzC-39B56/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/omnara/4SAu5j-ZzC-39B56/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/omnara/4SAu5j-ZzC-39B56/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/omnara/4SAu5j-ZzC-39B56/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/omnara/4SAu5j-ZzC-39B56/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/omnara/4SAu5j-ZzC-39B56/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"GitHub - Omnara\">\u003cmeta data-mint-head property=\"og:description\" content=\"Give agents scoped pull-request tools and configure PR event routing\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Omnara Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.omnara.com/integrations/github\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://omnara.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=GitHub\u0026amp;description=Give+agents+scoped+pull-request+tools+and+configure+PR+event+routing\u0026amp;theme=73ce439f50e9a6c9eef25f3f\u0026amp;signature=0b75fdec41e5453cf7b993014ca2e610ac86b070a06d10d5e3ee92e3c761e367\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"GitHub - Omnara\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Give agents scoped pull-request tools and configure PR event routing\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://omnara.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=GitHub\u0026amp;description=Give+agents+scoped+pull-request+tools+and+configure+PR+event+routing\u0026amp;theme=73ce439f50e9a6c9eef25f3f\u0026amp;signature=0b75fdec41e5453cf7b993014ca2e610ac86b070a06d10d5e3ee92e3c761e367\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/omnara/4SAu5j-ZzC-39B56/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Omnara\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4372cf\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.omnara.com/integrations/github\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/integrations/github.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.omnara.com/#organization\",\"name\":\"Omnara\",\"url\":\"https://docs.omnara.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/omnara/n37k7gqYv1cBmVaT/logo/omnara-logo.svg?fit=max\u0026auto=format\u0026n=n37k7gqYv1cBmVaT\u0026q=85\u0026s=5daf8948f5a1eea8bcd0ee573f967d93\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.omnara.com#website\",\"name\":\"Omnara\",\"url\":\"https://docs.omnara.com\",\"publisher\":{\"@id\":\"https://docs.omnara.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.omnara.com/integrations/github#webpage\",\"url\":\"https://docs.omnara.com/integrations/github\",\"name\":\"GitHub\",\"description\":\"Give agents scoped pull-request tools and configure PR event routing\",\"dateModified\":\"2026-11-13T23:03:42.561Z\",\"isPartOf\":{\"@id\":\"https://docs.omnara.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.omnara.com/integrations/github#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.omnara.com/integrations/github#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Integrations\",\"item\":\"https://docs.omnara.com/integrations/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GitHub\",\"item\":\"https://docs.omnara.com/integrations/github\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.omnara.com/integrations/github#article\",\"headline\":\"GitHub\",\"name\":\"GitHub\",\"description\":\"Give agents scoped pull-request tools and configure PR event routing\",\"url\":\"https://docs.omnara.com/integrations/github\",\"mainEntityOfPage\":{\"@id\":\"https://docs.omnara.com/integrations/github#webpage\"},\"dateModified\":\"2026-11-13T23:03:42.561Z\",\"publisher\":{\"@id\":\"https://docs.omnara.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.omnara.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Omnara\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Omnara\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/integrations/github.md","siteName":"Omnara","nav":{"global":{"anchors":[{"anchor":"Discord","icon":"discord","href":"https://discord.gg/Dc46sYk6e3"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Get started","pages":[{"title":"The open-source managed agent platform","sidebarTitle":"Introduction","icon":"hand-wave","href":"/introduction"},{"title":"Quickstart","icon":"rocket","href":"/quickstart"},{"title":"Concepts","icon":"hand-wave","href":"/concepts"}]},{"group":"Examples","pages":[{"title":"Examples","icon":"flask","href":"/examples/overview"},{"title":"In-app guide","icon":"arrow-pointer","href":"/examples/in-app-guide"},{"group":"GTM agents","pages":[{"title":"X signal agent","icon":"x-twitter","href":"/examples/x-signal-agent"},{"title":"Reddit signal agent","icon":"reddit","href":"/examples/reddit-signal-agent"},{"title":"LinkedIn signal agent","icon":"linkedin","href":"/examples/linkedin-signal-agent"},{"title":"SEO audit agent","icon":"magnifying-glass-chart","href":"/examples/seo-audit-agent"}]},{"group":"Engineering","pages":[{"title":"SRE agent","icon":"server","href":"/examples/sre-agent"},{"title":"Coding agent in Slack","icon":"code-pull-request","href":"/examples/slack-coding-agent"},{"title":"PR review agent","icon":"code-compare","href":"/examples/pr-review-agent"},{"title":"PR video agent","icon":"video","href":"/examples/pr-video-agent"},{"title":"Dependency roll-up agent","icon":"layer-group","href":"/examples/dependency-rollup-agent"},{"title":"PostHog analytics agent","icon":"chart-line","href":"/examples/posthog-analytics-agent"}]},{"group":"Operations","pages":[{"title":"Browser agent","icon":"globe","href":"/examples/browser-agent"},{"title":"Email agent","icon":"envelope","href":"/examples/email-agent"}]},{"title":"Video generation agent","icon":"video","href":"/examples/video-generation-agent"},{"title":"Live demos","icon":"circle-play","href":"/examples/live-demos"}]},{"group":"Agents","pages":[{"title":"Agents","icon":"robot","href":"/agents/overview"},{"title":"Configs \u0026 profiles","icon":"file-code","href":"/agents/configuration"},{"title":"Failure handling","icon":"shield-check","href":"/agents/failure-handling"}]},{"group":"Inputs \u0026 events","pages":[{"title":"Sending input","icon":"paper-plane","href":"/events/sending-input"},{"title":"Streaming events","icon":"tower-broadcast","href":"/events/streaming"},{"title":"Event webhooks","icon":"webhook","href":"/events/webhooks"},{"title":"Approvals \u0026 questions","icon":"user-check","href":"/events/interactions"},{"title":"Artifacts","icon":"box-archive","href":"/events/artifacts"}]},{"group":"Tools","pages":[{"title":"Tools \u0026 permissions","icon":"shield-check","href":"/tools/permissions"},{"title":"Built-in tools","icon":"toolbox","href":"/tools/built-in"},{"title":"Custom tools","icon":"plug","href":"/tools/custom"},{"title":"MCP servers","icon":"server","href":"/tools/mcp"},{"title":"Skills","icon":"graduation-cap","href":"/tools/skills"}]},{"group":"Machines","pages":[{"title":"Machines overview","icon":"computer","href":"/machines/overview"},{"title":"Connect a machine","icon":"plug-circle-plus","href":"/machines/connect"},{"title":"Machine pools","icon":"layer-group","href":"/machines/pools"},{"group":"Sandbox providers","icon":"cloud","pages":[{"title":"Sandbox providers","sidebarTitle":"Overview","icon":"cubes","href":"/machines/providers/overview"},{"title":"Agent37","icon":"https://mintlify.s3.us-west-1.amazonaws.com/omnara/logo/providers/agent37.svg","href":"/machines/providers/agent37"},{"title":"Arker","icon":"https://mintlify.s3.us-west-1.amazonaws.com/omnara/logo/providers/arker.svg","href":"/machines/providers/arker"},{"title":"Blaxel","icon":"https://mintlify.s3.us-west-1.amazonaws.com/omnara/logo/providers/blaxel.svg","href":"/machines/providers/blaxel"},{"title":"boxd","icon":"https://mintlify.s3.us-west-1.amazonaws.com/omnara/logo/providers/boxd.svg","href":"/machines/providers/boxd"},{"title":"CreateOS","icon":"https://mintlify.s3.us-west-1.amazonaws.com/omnara/logo/providers/createos.svg","href":"/machines/providers/createos"},{"title":"Daytona","icon":"https://mintlify.s3.us-west-1.amazonaws.com/omnara/logo/providers/daytona.svg","href":"/machines/providers/daytona"},{"title":"E2B","icon":"https://mintlify.s3.us-west-1.amazonaws.com/omnara/logo/providers/e2b.svg","href":"/machines/providers/e2b"},{"title":"Freestyle","icon":"https://mintlify.s3.us-west-1.amazonaws.com/omnara/logo/providers/freestyle.svg","href":"/machines/providers/freestyle"},{"title":"Modal","icon":"https://mintlify.s3.us-west-1.amazonaws.com/omnara/logo/providers/modal.svg","href":"/machines/providers/modal"},{"title":"Superserve","icon":"https://mintlify.s3.us-west-1.amazonaws.com/omnara/logo/providers/superserve.svg","href":"/machines/providers/superserve"},{"title":"Tenki","icon":"https://mintlify.s3.us-west-1.amazonaws.com/omnara/logo/providers/tenki.png","href":"/machines/providers/tenki"},{"title":"Unikraft Cloud","icon":"https://mintlify.s3.us-west-1.amazonaws.com/omnara/logo/providers/unikraft.png","href":"/machines/providers/unikraft"}]}]},{"group":"Organization","pages":[{"title":"Model providers","icon":"microchip-ai","href":"/organization/model-providers"},{"title":"Secrets","icon":"key","href":"/organization/secrets"},{"title":"Members \u0026 access","icon":"users","href":"/organization/members"}]},{"group":"Integrations","pages":[{"title":"Integrations","icon":"puzzle-piece","href":"/integrations/overview"},{"title":"Slack","description":"Launch thread agents from mentions and select Slack tools, subscriptions and approvals","icon":"slack","href":"/integrations/slack"},{"title":"GitHub","icon":"github","href":"/integrations/github"},{"title":"Discord","description":"Connect your bot and choose messaging tools, subscriptions and approval destinations","icon":"discord","href":"/integrations/discord"}]}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api/overview"}]},{"tab":"Changelog","icon":"list","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"GitHub - Omnara","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}