Developer Tools
Connect GitHub, GitLab, Jira, Linear, and other developer tools to Ballast.
Connect your development and project management tools to make code, issues, and documentation searchable.
Available Integrations
| Integration | Features |
|---|---|
| GitHub | Repos, issues, PRs, discussions |
| GitLab | Projects, issues, merge requests |
| Bitbucket | Repos, pull requests |
| Jira | Projects, issues, comments |
| Linear | Issues, projects, comments |
| Confluence | Spaces, pages |
| Figma | Files, comments |
| Miro | Boards |
GitHub
Index your GitHub organization:
What’s Indexed
- Repository README files
- Issues and issue comments
- Pull requests and PR comments
- Discussions
- Wiki pages
Configuration
| Option | Description |
|---|---|
| Organizations | Select which orgs to index |
| Repositories | All repos or specific selection |
| Content types | Issues, PRs, discussions, wikis |
| Include private | Index private repositories |
Setup
- Add GitHub to your collection
- Click Connect with GitHub
- Install the Ballast GitHub App
- Select organizations and repositories
GitLab
Index GitLab projects:
What’s Indexed
- Project descriptions
- Issues and issue comments
- Merge requests
- Wiki pages
Configuration
| Option | Description |
|---|---|
| Groups | Select GitLab groups |
| Projects | All or specific projects |
| Content types | Issues, MRs, wikis |
Jira
Index Jira projects and issues:
What’s Indexed
- Issue summaries and descriptions
- Comments
- Attachments (text extraction)
- Custom fields
Configuration
| Option | Description |
|---|---|
| Projects | Select Jira projects |
| Issue types | Filter by type (Bug, Story, etc.) |
| Status | Filter by status |
| Date range | How far back to index |
Linear
Index Linear issues and projects:
What’s Indexed
- Issues with descriptions
- Comments
- Project documentation
Setup
- Add Linear to your collection
- Authenticate with Linear
- Select teams and projects
Confluence
Index Confluence spaces and pages:
What’s Indexed
- Page content
- Comments
- Attachments (text extraction)
- Blog posts
Configuration
| Option | Description |
|---|---|
| Spaces | Select Confluence spaces |
| Include archived | Index archived pages |
| Include attachments | Extract text from files |
Figma
Index Figma design files:
What’s Indexed
- File names and descriptions
- Comments and feedback
- Component documentation
Use Cases
- Search for design feedback
- Find design decisions
- Link designs to related code/issues
Miro
Index Miro boards:
What’s Indexed
- Board content (text, sticky notes)
- Comments
- Board descriptions
Sync Behavior
| Type | Default Frequency |
|---|---|
| GitHub | Real-time (webhooks) or 15 min |
| GitLab | Every 15 minutes |
| Jira | Every 15 minutes |
| Linear | Every 15 minutes |
| Confluence | Every hour |
Best Practices
- Start specific - Index a few key repos/projects first
- Use webhooks - Enable real-time sync for GitHub when available
- Filter by date - For large Jira instances, limit historical data
- Exclude archived - Skip archived issues/projects to reduce noise