Tapioca integrates with your existing development workflow to automate time tracking, link code changes to tasks, and provide evidence of work. This section covers the Git-based integrations that power developer workflows.
Available Git Integrations
GitHub
Connect repositories, track PRs, and automate workflows
GitLab
Link merge requests, sync issues, and track CI/CD
Core Concepts
Evidence-Based Time Tracking
Tapioca uses your Git activity as evidence for time tracking. When you make commits, open pull requests, or participate in code reviews, these events are automatically captured and can be linked to tasks.
Why evidence matters:
- Verification - Prove that work was done during reported time
- Accuracy - Catch forgotten time entries by reviewing Git activity
- Automation - Auto-link commits mentioning task IDs
- Compliance - Audit trail for billing and reporting
Task Linking
Connect Git activity to Tapioca tasks in several ways:
| Method | Example | Automation Level |
|---|---|---|
| Task ID in commit | git commit -m "Fix bug TAP-123" | Automatic |
| Task ID in branch | feature/TAP-123-new-login | Automatic |
| Task ID in PR title | [TAP-123] Add new feature | Automatic |
| Manual linking | Link in Tapioca UI | Manual |
Consistent Naming
Webhook Events
Both GitHub and GitLab send webhooks to Tapioca when events occur:
Pull Request / Merge Request Events:
- Opened → Creates evidence, can move task to “In Progress”
- Merged → Creates evidence, can move task to “Review” or “Done”
- Closed → Creates evidence, optionally closes task
Code Review Events:
- Review submitted → Creates evidence of code review work
- Comments added → Creates evidence of collaboration
Commit Events:
- Push received → Links commits to tasks based on message patterns
Getting Started
Choose Your Provider
Set up GitHub, GitLab, or both based on where your code lives
Install the Integration
Follow the provider-specific setup to connect your organization
Map Repositories
Link Git repositories to Tapioca projects for automatic association
Configure Automation
Set up automatic task status updates and linking rules
Integration Features Comparison
| Feature | GitHub | GitLab |
|---|---|---|
| PR/MR to Task Linking | ✅ | ✅ |
| Commit Linking | ✅ | ✅ |
| Code Review Evidence | ✅ | ✅ |
| Issue Import | ✅ | ✅ |
| CI/CD Pipeline Tracking | ✅ | ✅ |
| Two-way Sync | ✅ | ✅ |
| Self-hosted Support | GitHub Enterprise | GitLab CE/EE |
| Time Tracking Sync | — | ✅ |
Multiple Providers
Security & Permissions
Tapioca follows the principle of least privilege:
- Read Access - View repositories, commits, PRs/MRs
- Webhook Events - Receive notifications of code changes
- No Write Access - We don’t modify your code or repository settings (unless explicitly enabled)
All webhook payloads are verified using cryptographic signatures to ensure authenticity. See Security for more details.