Connect Your Git Provider
Before you can use Tidra, you need to connect your GitHub or GitLab account.
Choose Your Git Provider
Tidra supports:
- GitHub (github.com)
- GitLab (gitlab.com or self-managed)
You'll use a Personal Access Token (PAT) to authenticate. This gives Tidra permission to:
- Read your repositories
- Create branches
- Open pull requests
- Update existing pull requests
Step-by-Step Setup
1. Choose your provider
In Tidra, navigate to Integrations in the left sidebar. You'll see tiles for GitHub and GitLab.
2. Create a Personal Access Token
Follow the guide for your provider:
These guides walk you through creating a token with the right permissions.
3. Connect to Tidra
Once you have your token:
- Return to Integrations in Tidra
- Select your Git provider
- Paste your Personal Access Token
- Click Install Integration
Tidra will verify the connection and load your repositories.
What Happens Next
Once connected, Tidra can:
- ✅ See your list of repositories
- ✅ Read code from those repositories
- ✅ Create branches when you run initiatives
- ✅ Open pull requests for your review
Tidra cannot:
- ❌ Delete repositories
- ❌ Merge pull requests (you control merging)
- ❌ Access repositories you don't have permission for
Security Best Practices
Use a Service Account (Recommended)
Instead of using your personal GitHub/GitLab account:
- Create a new account for Tidra (e.g.,
tidra-bot) - Grant it access to your repositories
- Use a PAT from that account
Benefits:
- Easier to audit (all Tidra actions are from one account)
- Doesn't affect your personal account
- Can revoke access without affecting you
- Clear separation of automated vs. manual changes
Token Management
- Set expiration dates (90 days recommended)
- Rotate tokens regularly
- Store tokens securely
- Revoke old tokens you're not using
Troubleshooting
"Authentication failed"
- Verify your token has the correct permissions
- Check that the token hasn't expired
- Make sure you copied the entire token
"Can't see my repositories"
- Verify the account that created the token has access to those repos
- For organization repos, the account may need to be added as a member
Still having issues? Check the full integration guides or contact [email protected].
Next Steps
Once your Git provider is connected:
Updated about 2 hours ago