Quickstart Guide

Overview

This guide walks you through:

1. Connecting your Git provider (5 min)
2. Creating your first initiative (5 min)
3. Reviewing and creating PRs (15 min)
4. Tracking progress (5 min)

Total time: ~30 minutes

---

Prerequisites

• GitHub or GitLab account
• Access to at least 5-10 repositories
• Ability to create Personal Access Tokens

---

Step 1: Connect Your Git Provider (5 min)

GitHub

1. Go to GitHub → Settings → Developer settings → Personal access tokens
2. Create new token (classic) with repo scope
3. Copy the token
4. In Tidra: Integrations → GitHub → Paste token → Install

GitLab

1. Go to GitLab → User Settings → Access Tokens
2. Create token with api, read_repository, write_repository scopes
3. Copy the token
4. In Tidra: Integrations → GitLab → Paste token → Install

See full guides: GitHub | GitLab

---

Step 2: Create an Initiative (5 min)

Let's create a simple initiative that adds a CODEOWNERS file.

1. Click New Initiative
2. Name: "Add CODEOWNERS file"
3. Description:

   Add a CODEOWNERS file to the root of each repository with:
   * @platform-team

4. Select repositories: Choose 5-10 repos you want to test with
5. Click Generate Changes

Wait 5-10 minutes while Tidra generates the changes.

---

Step 3: Review & Create PRs (15 min)

Review Changes

Once generation is complete:

1. You'll see a list of all repositories
2. Click on individual repos to see the diff
3. Verify the changes look correct

What to check:

• Is the CODEOWNERS file in the right location?
• Does the content match what you specified?
• Are there any errors or unexpected changes?

Create Pull Requests

If everything looks good:

1. Click Create Pull Requests
2. Wait 1-2 minutes while PRs are created
3. You'll see the dashboard update with PR links

View PRs in GitHub/GitLab

Click through to a few PRs and verify:

• Changes look correct
• Description is clear
• Branch name makes sense

---

Step 4: Track Progress (5 min)

Back in Tidra, you'll see the initiative dashboard:

Status Summary:

• See how many PRs are open, merged, blocked
• Track overall progress

Repository List:

• Click any repo to view its PR
• See status for each

As PRs get merged:

• Dashboard updates automatically
• See real-time progress

---

What's Next?

Merge your PRs: Your team reviews and merges the PRs as normal. Tidra doesn't auto-merge.

Watch the initiative complete: As PRs are merged, the initiative progresses to "Done".

Try another initiative: Now that you've done one, try:

• More repositories (20-50)
• Different type of change
• Something more complex

---

Common Patterns to Try Next

Easy:

• Update README files
• Add documentation sections
• Standardize config files

Medium:

• Update CI/CD pipelines
• Add security configs
• Update Docker files

Advanced:

• API migrations
• Dependency updates
• Code refactoring

---

Getting Help

Documentation:

• How it works
• Use cases
• Best practices

Support:

• Email: [email protected]

---

Key Takeaways

✅ Start small: 5-10 repos for your first initiative ✅ Be specific: Clear descriptions = better results ✅ Review first: Always check changes before creating PRs ✅ Iterate: Learn from each initiative to improve the next ✅ Scale up: Once comfortable, go bigger

You've completed the quickstart! You're ready to use Tidra for real initiatives.