AI Tooling

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 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

Before you begin

• LinearB role: Company Admin.
• GitHub permissions: ability to generate a PAT that can access Copilot metrics for the organizations you want to monitor.

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.
2. Select the scopes required by GitHub’s Copilot metrics API (for example, user:read, manage_billing:copilot, read:org as documented by GitHub).
3. See GitHub docs: Copilot metrics API (required scopes)
4. Copy the token and store it securely.

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.

---

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.

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