Skip to main content
Table of Contents

AI Tooling

Connect and manage AI coding tools, configure integrations, and control how LinearB collects AI usage data.

Steven Silverstone
Updated by Steven Silverstone
Table of Contents

AI Tooling – Setup & Configuration

Use this guide to enable LinearB AI, configure organization-wide automations, and connect supported developer AI tools such as GitHub Copilot and Cursor.

These settings are available under Settings → General and Settings → Company Settings → AI Tools.

Required permissions:
  • You must have access to AI Tools settings in LinearB to connect or manage an integration.
  • You may also need administrator access to the AI tool you are connecting, depending on the provider.

What you can configure

  • Enable or disable AI Services for your organization.
  • Configure LinearB AI and gitStream automations.
  • Connect supported AI providers and connection types.
  • View connected, disconnected, and failing integrations.
  • Edit an existing integration’s available configuration fields.
  • Disconnect or reconnect an integration.

AI Services

AI Services is the organization-wide control for LinearB’s AI processing, including AI-powered automations and AI-generated insights.

  • Go to Settings → General → AI Services.
  • Only users with the required administrative access can enable or disable AI Services.
  • When AI Services is disabled, LinearB stops running AI-powered automations and internal AI processing.
  • Other LinearB dashboards, including DORA, Delivery, Quality, and Throughput, continue to operate without AI-powered enhancements.
Note: If the AI Services setting is unavailable or cannot be enabled, contact LinearB Support .

LinearB AI and automations

LinearB AI and gitStream automations can review pull requests, generate descriptions, apply labels, and automate other repository workflows.

If gitStream was not configured during onboarding, use the installation guide for your Git provider and environment.

Learn more:

AI Tool integrations

Go to Settings → Company Settings → AI Tools → Integrations to connect and manage developer AI tools.

Browse integrations

The Integrations page uses a sidebar to display each configured provider and connection type.

  • Select Connected to view active integrations, including integrations that currently have a validation or collection error.
  • Select Disconnected to view integrations that were previously disconnected.
  • Select an integration in the sidebar to view its status, configuration, and available actions.
Integration names: When a provider supports more than one connection type, the sidebar identifies the configured variant. For example, it may display GitHub Copilot – Classic Token or Claude Code – OpenTelemetry.

Add an integration

  1. Go to Settings → Company Settings → AI Tools → Integrations.
  2. Click Add New.
  3. Select the AI provider you want to connect.
  4. Select a connection type or variant, when more than one is available.
  5. Enter the credentials and other required configuration details.
  6. Complete validation and click Connect.
Note: Only one active integration for the same provider and connection type can be connected at a time. A failing integration still counts as active.

Manage an integration

The integration settings use the following actions:

  • Connect — create and activate a new integration.
  • Edit — update the available settings for an existing connected integration.
  • Disconnect — stop an active integration while retaining it in the Disconnected list.
  • Reconnect — validate and reactivate a previously disconnected integration.

Edit a connected integration

  1. Select Connected in the Integrations sidebar.
  2. Select the integration you want to update.
  3. Under Main Settings, click Edit.
  4. Update the available configuration fields.
  5. Click Save changes to apply the update or Cancel to discard it.
Permissions: Anyone who has access to AI Tools settings can edit an integration. No additional LinearB permission is required specifically for the Edit action.
Important: A provider or connection type cannot be changed through Edit mode. To use a different provider or variant, add a new integration.

What happens to historical data after an edit?

Editing an integration does not delete previously collected metrics.

  • LinearB may recollect a recent window of data after the changes are saved.
  • Recollected records are updated in place and are not counted twice.
  • Data older than the provider’s recollection window remains unchanged.
  • The available recollection window and the time required for new data to appear vary by provider and connection type.
Important: Updating credentials or connection settings can temporarily interrupt data collection if the corresponding provider-side configuration is not also updated. Follow the instructions shown for the selected integration.

Disconnect or reconnect an integration

To disconnect an active integration:

  1. Select the integration from the Connected list.
  2. Click Disconnect.
  3. Confirm the action.

The integration remains available under Disconnected.

To reconnect it:

  1. Select Disconnected.
  2. Select the integration.
  3. Click Reconnect.
  4. Enter or confirm the required credentials.
  5. Complete validation to reactivate the integration.
Note: If another active integration uses the same provider and connection type, disconnect that integration before reconnecting the previous one.

Connect GitHub Copilot

The GitHub Copilot integration allows LinearB to collect Copilot adoption and usage data across your GitHub organizations.

Before you begin

  • LinearB access: Access to AI Tools settings.
  • GitHub access: An organization owner, enterprise owner, or billing manager account capable of creating a token with the required Copilot permissions.
Security: Treat the GitHub personal access token like a password. Store it securely and rotate it according to your organization’s security policies.

Step 1 – Create a GitHub token

  1. Create a new personal access token in GitHub.
  2. Add the scopes required by GitHub’s Copilot metrics API, including the applicable organization and Copilot billing permissions.
  3. Copy the token and store it securely.

GitHub documentation:

Step 2 – Connect GitHub Copilot in LinearB

  1. Go to Settings → Company Settings → AI Tools → Integrations.
  2. Click Add New.
  3. Select GitHub Copilot.
  4. Select the applicable connection type.
  5. Paste the GitHub token into the Token field.
  6. Choose which GitHub organizations to track:
    • Include all organizations — track all organizations visible to the token.
    • Select organizations by regex — track organizations whose names match a pattern.
    • Select organizations manually — choose individual organizations.
  7. Complete validation and click Connect.
  8. Confirm that the integration appears under Connected.

Update GitHub Copilot credentials or settings

  1. Go to Settings → Company Settings → AI Tools → Integrations.
  2. Select the connected GitHub Copilot integration.
  3. Under Main Settings, click Edit.
  4. Update the token or available organization settings.
  5. Click Save changes.
Historical data: Editing Copilot settings does not delete previously collected metrics. LinearB may recollect and update recent data. Older data remains available.

Connect Cursor

The Cursor integration allows LinearB to collect adoption and usage data from your Cursor organization.

Before you begin

  • LinearB access: Access to AI Tools settings.
  • Cursor access: An administrator account that can generate an Admin API key.
Security: Treat the Cursor Admin API key like a password. Copy it immediately after creation because Cursor may not display it again.

Step 1 – Generate a Cursor Admin API key

  1. Open Account Settings in Cursor.
  2. Locate the Admin API Keys section.
  3. Click Create New API Key.
  4. Enter a recognizable name, such as LinearB Usage Integration.
  5. Copy and securely store the generated key.

Step 2 – Connect Cursor in LinearB

  1. Go to Settings → Company Settings → AI Tools → Integrations.
  2. Click Add New.
  3. Select Cursor.
  4. Select the applicable connection type.
  5. Paste the Admin API key into the Token field.
  6. Complete validation and click Connect.
  7. Confirm that the integration appears under Connected.

Update Cursor credentials

  1. Go to Settings → Company Settings → AI Tools → Integrations.
  2. Select the connected Cursor integration.
  3. Under Main Settings, click Edit.
  4. Enter the new Admin API key.
  5. Click Save changes.
Historical data: Editing the Cursor integration does not delete previously collected metrics. LinearB may recollect and update recent data while retaining older data.

Troubleshooting

An integration appears under Connected with an error

An integration with a validation or collection error remains under Connected because it is still active.

  1. Select the integration in the sidebar.
  2. Review the error displayed in the integration details.
  3. Under Main Settings, click Edit.
  4. Correct the credentials or configuration.
  5. Click Save changes.

Saving the integration clears its current failure status. The next validation or collection attempt determines whether the integration is working successfully.

An integration is disconnected
  1. Go to Settings → Company Settings → AI Tools → Integrations.
  2. Select Disconnected.
  3. Select the integration you want to restore.
  4. Click Reconnect.
  5. Enter or confirm the required credentials and complete validation.
AI usage data is missing or outdated
  • Confirm that the integration appears under Connected without an error indicator.
  • Select the integration and review its validation or collection status.
  • Confirm that its credentials have the permissions required by the provider.
  • Allow time for LinearB to collect and process new usage data.
  • Confirm that your reporting view includes the expected date range, contributors, and teams.

If the issue continues after following these steps, contact LinearB Support .

How did we do?

Enable LinearB AI services

Contact