Connect GitHub

The GitHub connector installs Orcha's read-only GitHub App on the repositories you choose. It reads repository contents, pull requests, issues, and discussions, and never writes to GitHub.

You need the workspace admin role in Orcha and admin access to the GitHub account or organization.

Add the connector

1. Open Connectors and choose GitHub. You are sent to GitHub's App installation page.
2. Pick the account or organization and select the repositories to grant. Permissions are read-only: contents, pull requests, issues, and discussions.
3. Approve. Orcha catalogs each granted repository: file tree, sizes, and revisions, without downloading bodies.

You can change the repository grant any time from GitHub's installation settings; Orcha follows the change on the next sync.

Choose what gets indexed

Repositories start on Index essentials: READMEs, docs, and guidance files are indexed, while the rest of the tree stays catalog-only. Add rules per path to widen or narrow that, for example full indexing under docs/ and exclusion under vendor/. Common build and dependency directories are ignored by default, with the skips disclosed in the catalog. Code files are chunked at declaration boundaries and carry symbol metadata, so search hits land on functions and classes rather than arbitrary line windows.

Use it

Search results cite the exact file at the exact commit, with a link back to GitHub. Catalog-only files are still reachable: balanced search can fetch a decisively matching file live without storing it, and webhooks keep indexed content current as you push.

Remove it

• Pause stops syncing while keeping indexed content searchable.
• Revoke invalidates Orcha's access and deactivates the repositories; indexed content is kept until you disconnect or reconnect.
• Disconnect purges indexed documents, search chunks, cached content, and sync state from your workspace.
• From GitHub: uninstall the Orcha App under Settings, Applications, Installed GitHub Apps (personal or organization). GitHub notifies Orcha, which deactivates the connection; disconnect in Orcha to purge indexed content as well.