Linear Integration

Connect Jetson to Linear to create issues directly from customer feedback. Jetson also syncs status changes bidirectionally—when you move an issue in Linear, Jetson updates automatically.

Setting up Linear

Connect your workspace

1. Go to Settings in Jetson
2. Under Destinations, click Connect Linear
3. You'll be redirected to Linear to authorize
4. Grant Jetson access to your workspace
5. You'll be returned to Jetson

What Jetson can do

When connected, Jetson can:

• Create issues in your Linear workspace
• Read teams, projects, and workflow states
• Sync status changes bidirectionally

Jetson cannot:

• Delete issues
• Access private information beyond issue tracking
• Modify your Linear workspace settings

Permissions requested

Jetson requests these Linear scopes:

Configuring products

Select a team

After connecting Linear, configure each product:

1. Go to Settings > Products
2. Select your product
3. Choose Linear as the output destination
4. Select which Linear team to create issues in
5. Optionally select a project within that team
6. Save your changes

Each product can use a different team or project.

Configure state mapping

Jetson maps Linear workflow states to Jetson statuses. The defaults work for most setups:

To customize the mapping:

1. Open your product settings
2. Find the State Mapping section
3. For each Linear state, choose the Jetson status
4. Save your changes

Custom mappings let you handle workflows with multiple "In Progress" states or custom state types.

Creating Linear issues

From a bug or feature

1. Open any bug or feature in Jetson
2. Click Create Linear Issue
3. Review the generated issue content
4. Confirm to create

The issue appears in your configured Linear team and project.

What's included

Linear issues include:

• Title — From Jetson's analysis
• Description — Summary of customer feedback
• Customer count — How many customers reported this
• Link back to Jetson — For full context

Two-way status sync

How it works

When you change an issue's status in Linear, Jetson updates automatically:

• Move to "Done" in Linear → Jetson marks as Resolved
• Move to "In Progress" → Jetson marks as Active
• Move to "Backlog" → Jetson marks as Inactive
• Cancel in Linear → Jetson marks as Deferred

The sync works the other way too. Change a work item's status in Jetson and the Linear issue updates.

Requirements

Two-way sync requires:

• Admin role in Linear (to create webhooks)
• Linear connected with full permissions
• State mapping configured for your product

If you connected without admin access, you'll see a warning. Reconnect with an admin account to enable two-way sync.

Disconnecting

To disconnect Linear:

1. Go to Settings
2. Find Linear under Destinations
3. Click Disconnect

What happens:

• No new issues can be created
• Two-way sync stops
• Existing Linear issues remain
• Links in Jetson still work
• You can reconnect anytime

Reconnecting Linear

If Linear stops working or you need to change accounts:

1. Disconnect the current connection (see above)
2. Click Connect Linear again
3. Authorize with your Linear account
4. Reconfigure your products if needed

Common reasons to reconnect:

• Changed Linear workspaces
• Token expired or was revoked
• Need to grant additional permissions
• Switching to an admin account for two-way sync

Multiple products

One connection, many products

A single Linear connection serves your entire organization:

• Connect Linear once
• Configure each product with its own team/project
• Each product creates issues in its configured location

Different teams per product

Products can target different Linear teams:

• Support product → Engineering team
• Sales product → Product team
• Enterprise product → Enterprise team

Configure this in each product's settings.

Next steps

• Understanding Work Items — Learn about bugs and features before creating issues
• GitHub Integration — Alternative issue destination
• How Classification Works — Understand how Jetson categorizes feedback