Skip to main content
Deutsch (Deutschland) Español Français Hebrew (Israel) Italiano Português

AI Tooling

Heather Hazell
Updated

AI Tooling – Setup & Configuration

Use this guide to turn on LinearB AI, configure organization-wide automations, and connect developer AI tools like GitHub Copilot and Cursor. These settings live under Settings → General and Settings → Company Settings → AI Tools.

Required Permissions:

  • LinearB: Admin
  • Github: Admin, if applicable
  • Cursor: Admin, if applicable

TL;DR: What you configure here

  • Turn AI Services on or off for your entire organization.
  • Choose the operation mode for AI automations (Managed vs. Repository-based).
  • Enable LinearB AI automations like AI Review, AI Description, and labeling rules.
  • Connect GitHub Copilot and Cursor so usage appears in AI Insights.

AI Services (org-wide toggle)

AI Services is the master switch for LinearB’s AI processing, including AI-driven automations and AI-generated insights.

  • Location: Settings → General → Section: AI Services .
  • Only admins can enable or disable AI Services.
  • When disabled, LinearB stops running AI-powered automations and internal AI processing.
  • Other dashboards (for example, DORA, Delivery, Quality, Throughput) continue to work.

LinearB AI & Automations

If gitStream AI was not set up during your inital onboarding. Please reference the gitStream installation guide relevant to your git environment.

Connecting GitHub Copilot

LinearB integrates with GitHub Copilot Usuage API to track adoption, usage, and acceptance metrics across your GitHub organizations. Configuration is done via a GitHub Personal Access Token (PAT). Copilot activity appears in AI Insights → AI Tools Usage and contributes to AI Adoption. As well, find cursor spefiic metircs in Metrics → Metrics Dashboard → Copilot.

Organization-level Copilot metrics may appear in AI Insights even if no users are shown as connected in the Users page. User-level visibility depends on Copilot usage metrics being enabled in GitHub and successful GitHub-to-LinearB identity mapping.

Before you begin

  • LinearB role: Company Admin.
  • GitHub permissions: the GitHub account that generates the PAT must have admin permissions
Security note: Treat the PAT like a password. Store it securely and rotate it according to your internal security policies.

Step 1 – Create a GitHub PAT for Copilot metrics

  1. In GitHub, create a new Personal Access Token (classic).
    1. In GitHub → User Profile → Settings → Developer Settings
  2. Select the scopes required by GitHub’s Copilot metrics API (read:user, or read:org)
  3. Copy the token and store it securely.

Step 2 – Enable  Copilot Usuage Mertrics in GitHub

  1. Go to your GitHub Organization → Open Settings → Navigate to Copilot → Policies.
  2.  Under Features, confirm “Copilot usage metrics” is enabled.

Step 2 – Connect Copilot in LinearB

  1. In LinearB, go to Settings → Company Settings → AI Tools → GitHub Copilot.
  2. Paste the PAT into the Token field.
  3. Choose which organizations to track:
    • Include all organizations – track all GitHub orgs visible to the token.
    • Select organizations by regex – include orgs whose names match a pattern.
    • Select organizations manually – pick orgs from the list.
  4. Click Save, then verify the status shows Connected with a recent Last updated timestamp.

Copilot - backfilling data: When you connect via the Copilot API, LinearB automatically loads up to the last 90 days of historical data. This backfill runs by default; no extra steps are required.

Copilot sync time varies by provider and data package size.

How to Reauthorize Copilot

  1. Generate a new PAT in GitHub if the old token expired, was revoked, or changed scopes.
  2. In LinearB, open Settings → Company Settings → AI Tools → GitHub Copilot.
  3. Paste the new token and click Reauthorize.
  4. Optionally:
    • Reset data – clears existing Copilot metrics and backfills the last 90 days.
    • Reset setting – allows you to reselect which organizations to track.
  5. Confirm the status returns to Connected.

Connecting Cursor

Cursor integration lets LinearB track adoption and usage metrics for Cursor. Cursor activity appears in AI Insights → AI Tools Usage and contributes to AI Adoption. As well, find cursor spefiic metircs in Metrics → Metrics Dashboard → Cursor

Before you begin

  • LinearB role: Company Admin.
  • Cursor role: admin permissions to generate an Admin API key.
Security note: Treat the Cursor Admin API key like a password. Copy it immediately after creation; Cursor will not show it again.

Step 1 – Generate a Cursor Admin API key

  1. In Cursor, open Account Settings.
  2. Locate the Admin API Keys section.
  3. Click Create New API Key, name it (for example, LinearB Usage Integration), and copy the key.

Step 2 – Connect Cursor in LinearB

  1. In LinearB, go to Settings → Company Settings → AI Tools → Cursor.
  2. Paste the Admin API key into the Token field.
  3. Click Save.
  4. Verify the status shows Connected with a recent Last updated timestamp.

Cursor - Backfilling data: When you connect via the Cursor API, LinearB is limited to loading up to the last 30 days of historical data. This backfill runs by default; no extra steps are required.

Cursor sync time varies by provider and data package size.

How to Reauthorize Cursor

  1. Generate a new Admin API key in Cursor if the old key expires or is revoked.
  2. In LinearB, open Settings → Company Settings → AI Tools → Cursor.
  3. Paste the new key and click Reauthorize.
  4. Confirm the status returns to Connected.

Connecting Claude

Before you begin

  • LinearB role: Company Admin.
  • Cursor role: admin permissions to generate an Admin API key.
Security note: Treat the Claude Admin API key like a password. Copy it immediately after creation; Claude will not show it again.

Step 1 – Generate a Claude Admin API key

  1. You'll need to get your API key from the Claude Console1. You can access your API keys at https://platform.claude.com/settings/keys [(1)]
  2. Click + Create Key under section: Create An API Key
    1. Please note: The admin token does not require scopes. 
  3. Name it (for example, LinearB Usage Integration), and copy the key.

Step 2 – Connect Claude in LinearB

  1. In LinearB, go to Settings → Company Settings → AI Tools → Claude.
  2. Paste the Admin API key into the Token field.
  3. Click Save.
  4. Verify the status shows Connected with a recent Last updated timestamp.

Claude - Backfilling data: When you connect via the Claude API, LinearB is limited to loading up to the last 90 days of historical data. This backfill runs by default; no extra steps are required.

Claude sync time varies by provider and data package size.

How to Reauthorize Claude

  1. Generate a new Admin API key in Cursor if the old key expires or is revoked.
  2. In LinearB, open Settings → Company Settings → AI Tools → Cursor.
  3. Paste the new key and click Reauthorize.
  4. Confirm the status returns to Connected.

Troubleshooting

No AI data in AI Insights
  • Confirm AI Services is enabled in Settings → General.
  • Check that Managed Mode is selected for LinearB AI & Automations.
  • Verify that Copilot / Cursor tokens are valid and show Connected status.
  • Allow some time after connecting; usage data may not appear instantly.
Disconnected Copilot or Cursor status
  • Recreate the PAT / Admin API key with the required permissions.
  • Paste the new token in Settings → Company Settings → AI Tools and reauthorize.
Unable to see user metrics for Copilot
  • Go to your GitHub Organization → Open Settings → Navigate to Copilot → Policies. Under Features, confirm “Copilot usage metrics” is enabled.

If you still see issues after following these steps, please contact LinearB Support.

Related articles