Phase 3 — AI Tools & gitStream

In this phase, enable AI-powered features and automation in LinearB Essentials. These capabilities provide visibility into AI-assisted development and enable automation workflows using gitStream.

Step 1 — Enable LinearB AI Services

AI Services power several capabilities within LinearB Essentials, including AI-powered pull request insights, automation actions, and developer productivity analytics.

To enable AI Services:

1. Go to Company Settings → General.
2. Scroll to the AI Services section.
3. Toggle Enable LinearB AI Services to ON.

Expected result:

• AI-powered features become available across your workspace
• AI automation rules can be enabled in gitStream
• AI insights begin appearing in dashboards

Step 2 — Configure AI Tools

LinearB Essentials provides visibility into AI-assisted development by integrating with supported AI coding tools. Once configured, LinearB can detect AI-generated code and track AI usage across pull requests.

Supported AI tools:

• GitHub Copilot
• Cursor

To configure AI tools:

1. Go to Company Settings → AI Tools.
2. Select the AI tool you want to enable.
3. Enter the required API token.
4. Save your configuration.

For GitHub Copilot, ensure the following scopes are available when generating the token:

• read:org
• read:user
• manage_billing:copilot

Expected result:

• AI usage begins appearing in AI dashboards
• Pull requests show AI contribution indicators
• AI activity can be used in automation rules

Step 3 — Enable gitStream Automation

gitStream powers automation in LinearB Essentials. It can automatically review pull requests, apply labels, generate descriptions, and enforce workflow rules.

LinearB supports two automation modes depending on how much control your team wants over automation rules.

Managed Mode (Recommended)

Managed Mode provides ready-to-use automation without requiring YAML configuration. Automations are managed directly inside the LinearB interface.

To enable Managed Mode:

1. Go to Company Settings → AI Tools.
2. Open the Managed Automations section.
3. Enable the automations you want to use.

Available automations include:

• AI Review
• AI Description
• Estimated Time to Review
• Label Agents as Co-authors
• Dependabot Minor Bump Approval
• Dependabot Patch Bump Approval

Expected result:

• Automation runs automatically on new pull requests
• Configured automation rules appear in LinearB

Self-Managed Mode (Advanced)

Self-Managed Mode allows teams to create custom automation rules using gitStream YAML configuration files stored inside their repositories.

How Self-Managed Mode works:

1. Create a .cm directory in your repository.
2. Add gitStream YAML rule files.
3. Commit and push the automation rules.

Example automation files might include:

• auto-review.yml
• label-pr.yml
• approval-policy.yml

For installation instructions and automation examples, see the gitStream setup guides .

What Success Looks Like

• AI Services are enabled
• AI tools are connected
• AI insights begin appearing in dashboards
• gitStream automation runs on pull requests