GitHub Integration

Note: GitHub App installation is coming soon. For now, use a Personal Access Token (PAT).

Authenticating with a Personal Access Token

Personal Access Tokens (PATs) allow Tidra to access your GitHub repositories, create branches, and open pull requests.

Creating a Personal Access Token

1. Navigate to your GitHub account settings
2. Go to Developer settings → Personal access tokens → Tokens (classic)
3. Click Generate new token → Generate new token (classic)
4. Give your token a descriptive name (e.g., "Tidra")
5. Set an expiration date (we recommend 90 days or less for security)
6. Select the following scopes:

Required scopes:

• repo (Full control of private repositories)
  • This grants read/write access to code, pull requests, and issues

7. Click Generate token
8. Copy the token immediately (you won't be able to see it again)

Adding GitHub to Tidra

1. Navigate to Integrations in the left sidebar
2. Select the GitHub tile
3. Paste your Personal Access Token in the Access Token field
4. Click Install Integration

What Tidra Can Do

Once connected, Tidra will be able to:

• Read your repositories
• Create branches for code changes
• Open pull requests for review
• Update existing pull requests

Security Best Practices

Use a dedicated service account:

• Create a separate GitHub account for Tidra (e.g., tidra-bot)
• Grant this account access to your repositories
• Use a PAT from this account instead of your personal account
• This allows you to:
  • Easily audit what Tidra is doing
  • Revoke access without affecting your personal account
  • Set appropriate permissions for automation

Token management:

• Set token expiration dates
• Rotate tokens regularly
• Store tokens securely
• Revoke tokens you're no longer using

Troubleshooting

"Authentication failed" error:

• Verify your token has the repo scope
• Check that the token hasn't expired
• Ensure the token is from an account that has access to your repositories

Can't see certain repositories:

• Verify the account that created the token has access to those repositories
• For organization repositories, the account may need to be added as a member

Pull requests aren't being created:

• Verify the repo scope is enabled
• Check that the account has write access to the repository

Coming Soon

GitHub App Installation:
We're working on a GitHub App that will provide more granular permissions and better security. You'll be able to:

• Grant access to specific repositories only
• Use GitHub's native permission model
• Avoid managing long-lived tokens
• Get automatic token rotation

Stay tuned for updates!