GitHub

GitHub is the required integration: agents clone repositories, react to repository events, and post back through the Ellipsis GitHub App. Everything else is optional.

Install the app

Go to app.ellipsis.dev/install, sign in with GitHub, and click Install on GitHub. GitHub asks which account or organization to install on and which repositories to grant: all of them, or a selected list. Agents can only see the repositories you pick.

If you are not an organization admin, the same flow files an installation request; ask your admin to approve it, and the installation completes when they do.

When the installation lands, the dashboard confirms it and offers your signup credit: $100 for organizations, $10 for personal accounts. That is the only setup; the Cloud Agents quick start goes from here to a running agent.

What it enables

• Triggers. Agent configs sync from your default branch, and pull request, push, issue, and mention events start agents. @ellipsis in any PR or issue comment gets an answer in the thread.
• Per-session scoped tokens. Each session's sandbox gets its own GitHub token, minted from this installation when the sandbox starts. It lives one hour, covers only the sandbox's repositories, and dies with the sandbox; YAML narrows it further, down to read-only. No personal credential is ever involved. Full model: Permissions.
• Code review posting. With Code Review enabled, Ellipsis posts one comment-only review per push, anchored to the commit it reviewed. It never approves, requests changes, or pushes commits.
• PR comments and pull requests. Agents open pull requests, edit descriptions, and comment through the installation, always as the Ellipsis bot.

Managing repos

Repository access lives on GitHub, not in Ellipsis. The dashboard's Integrations → GitHub page lists every repository Ellipsis can see and links to your installation's settings on GitHub, where you add or remove repositories at any time. Newly added repositories are available to agents as soon as GitHub confirms the change.

Two consequences of a selected-repositories installation:

• An agent config that names an ungranted repository cannot clone it; grant the repository first.
• Code review only covers pull requests in granted repositories.

Uninstalling removes all repository access; do it from the same dashboard page (organization admins only) or from GitHub directly. Session history and assets remain in your Ellipsis account either way.