Guides
v1.0
Guides
Start typing to search…
  1. Reference

Troubleshooting

Common issues and how to resolve them.

Connection Issues

Cannot Connect to GitHub

Error: "Authentication failed"

Solutions:

  1. Verify your Personal Access Token is correct
  2. Check the token has repo scope enabled
  3. Ensure the token hasn't expired
  4. Try generating a new token

Error: "Can't see my repositories"

Solutions:

  1. Verify the account that created the token has access to those repos
  2. For organization repos, the account must be a member
  3. Check if repos are archived (Tidra skips archived repos)

Cannot Connect to GitLab

Error: "Cannot connect to GitLab instance"

Solutions:

  1. Verify the GitLab URL is correct (include https://)
  2. Check network access (is GitLab reachable from Tidra?)
  3. Don't include /api/v4 in the URL - Tidra adds this automatically

Error: "SSL certificate verification failed"

Solutions:

  1. Your GitLab may use a self-signed certificate
  2. Contact support to configure certificate trust

Initiative Issues

Generation Takes Too Long

Problem: Code generation is taking longer than expected

Solutions:

  1. Large repos take longer - wait 10-15 minutes
  2. Many repos (50+) process in parallel but still take time
  3. Check status - may be waiting for you to review
  4. If stuck >30 minutes, contact support

Poor Code Quality

Problem: Generated code isn't correct or has issues

Solutions:

  1. Review your description - is it specific enough?
  2. Add examples - show exact before/after code
  3. Test on fewer repos - try 3-5 repos first
  4. Refine and regenerate - improve description and try again
  5. Check complexity - very complex changes may need breaking down

Common causes:

  • Description too vague
  • Complex change without examples
  • Edge cases not mentioned
  • Mixed changes (do one thing per initiative)

No Changes Generated

Problem: Tidra says "no changes needed" for repos that do need changes

Solutions:

  1. Check if change already exists (Tidra detects this)
  2. Verify description matches actual repo structure
  3. Check file paths - are they correct?
  4. Make description more explicit about what to look for

Some Repos Failed

Problem: Some repositories show errors

Common reasons:

  • File not found (repo structure different than expected)
  • Permission issue (can't access repo)
  • Syntax error in generated code

Solutions:

  1. Click the repo to see specific error
  2. Adjust description to handle this case
  3. Regenerate for just those repos
  4. Or skip those repos and handle manually

Pull Request Issues

PRs Not Being Created

Problem: "Create Pull Requests" succeeds but no PRs appear

Solutions:

  1. Check the repository directly - PR may exist
  2. Verify the account has write access to repos
  3. Check branch protection rules - may be blocking
  4. Look for error messages in Tidra

PR Creation Failed

Problem: Some PRs failed to create

Common reasons:

  • Branch already exists with that name
  • No write permission to repository
  • Branch protection rules block direct pushes

Solutions:

  1. Click the repo to see specific error
  2. Check permissions
  3. Retry PR creation
  4. Or create manually if needed

PRs Created But Not Updating

Problem: Dashboard not showing PR status updates

Solutions:

  1. Refresh the page
  2. Check directly in GitHub/GitLab
  3. May take a few minutes to sync
  4. If stuck, contact support

Performance Issues

Slow Loading

Problem: Tidra is slow to load

Solutions:

  1. Check your internet connection
  2. Try a different browser
  3. Clear browser cache
  4. Contact support if persistent

Timeout Errors

Problem: Operations timing out

Solutions:

  1. Try with fewer repositories
  2. Simplify the description
  3. Break into multiple smaller initiatives
  4. Contact support

Integration Issues

Slack Notifications Not Working

Problem: Not receiving Slack notifications

Solutions:

  1. Check Slack integration is connected
  2. Verify channel permissions (Tidra bot must be in channel)
  3. Check notification settings in Tidra
  4. Reconnect Slack integration

Git Provider Disconnected

Problem: Git integration shows as disconnected

Solutions:

  1. Check if token expired
  2. Regenerate token with same permissions
  3. Reconnect in Integrations page
  4. Verify token has correct scopes

Data Issues

Missing Repositories

Problem: Some repositories don't appear in Tidra

Solutions:

  1. Verify account has access to those repos
  2. Check if repos are archived (Tidra skips these)
  3. Try disconnecting and reconnecting Git provider
  4. Wait a few minutes and refresh

Incorrect Repository Count

Problem: Repository count doesn't match GitHub/GitLab

Explanation: Tidra may filter out:

  • Archived repositories
  • Repositories without code
  • Repositories you don't have write access to

This is normal. Tidra only shows repos it can work with.

Getting Help

Before Contacting Support

Gather this information:

  1. What were you trying to do?
  2. What happened instead?
  3. Error messages (screenshot if possible)
  4. Initiative ID or repository name
  5. Browser and version

Contact Support

Email: [email protected] Response time: Usually within 24 hours

Known Limitations

What Tidra Can't Do (Yet)

  • Run build commands with private dependencies (coming soon)
  • Edit binary files
  • Make interactive decisions
  • Auto-merge pull requests
  • Run tests automatically

Workarounds

For these limitations, use Tidra for code generation and handle these steps manually or through your existing CI/CD.

Next Steps

Updated about 2 hours ago