GitHub App
How Sinatra connects to GitHub, and the access it requests.
Sinatra connects to GitHub through its GitHub App. You install it from the dashboard — there's nothing to create yourself.
Connecting
From your workspace settings, install the Sinatra GitHub App on the organization or personal account you want to work in, then choose which repositories to enable. You can change the enabled repositories at any time.
Access requested
- Repository contents: read and write, so the agent can check out your code and push the branch it works on.
- Pull requests: read and write, so it can open PRs and reply to review threads.
- Issues: read and write, so you can hand Sinatra an issue with the Sinatra label, and it can comment, react, and update the issue.
- Checks: read, so it can see when your CI finishes and send the agent back to fix a failing PR.
- Metadata: read, the baseline GitHub requires.
Sinatra only ever pushes branches and opens pull requests. It never merges; that stays with you and your CI.
Webhook events
Sinatra subscribes to installation, installation repositories, repository, push, issue, issue comment, pull request, pull request review, and check suite events. Together these let it track which repos are enabled (including repos added to or removed from an existing installation), pick up label additions and @-mentions, react to review feedback, and keep work in sync.