Linear Integration
How to connect Linear to Brief for AI-powered velocity tracking and work pipeline visibility. Give your AI coding agents context about what's being built and team capacity.
Brief + Linear gives your AI coding agents real-time understanding of your work pipeline. Instead of AI tools guessing what to build next, they can query Brief to see what's in progress, what's blocked, and how fast your team ships.
| Without Linear | With Linear Connected |
|---|---|
| AI guesses priorities | AI sees your actual backlog |
| No velocity context | AI knows your shipping speed |
| Decisions disconnected from work | Decisions linked to tickets |
Linear is one of the best first integrations for Brief—it takes 30 seconds to connect and immediately gives Brief understanding of what you're building, how fast you ship, and your work pipeline.
What data does Brief extract from Linear?
- Issues and Projects — What's backlogged, in progress, and shipped
- Velocity Metrics — Release frequency, cycle time, throughput trends
- Team Structure — Who's working on what
- Labels and Priorities — How you organize work
Why should I connect Linear to Brief?
Brief + Linear gives your AI coding agents visibility into your work pipeline, velocity, and strategic decisions.
Work Pipeline
See what's being built right now vs. what's planned vs. what shipped.
Velocity Understanding
Brief calculates how fast your team ships based on issue completion patterns.
Strategic Decisions
Issues tagged with "decision" or containing ADR-style content are extracted as decisions.
How do I set up the Linear integration?
- Go to Integrations in Brief
- Find Linear and click Connect
- Authorize Brief in Linear's OAuth flow
- Done! Brief starts syncing immediately
Initial sync: 30-60 seconds
Updates: Real-time via webhooks
What happens after I connect Linear?
After connecting:
- Immediate sync — Brief fetches recent issues (last 90 days)
- Webhook registration — Brief subscribes to Linear updates
- Background analysis — Velocity agent calculates metrics
- You review — Approve extracted features and velocity data
Common Issues
Why aren't any issues syncing?
Your Linear workspace may be empty or all issues are older than 90 days. Create some issues or check that recent work exists.
Why isn't the webhook working?
Webhook failed to register during initial connection. Go to Linear → Settings → Webhooks and check if Brief webhook exists. If missing, disconnect and reconnect in Brief.
Why did it connect to the wrong workspace?
You authorized with the wrong Linear account. Disconnect in Brief, then reconnect with the correct Linear account.
What's Next?
Now that Linear is connected:
- Connect GitHub — Cross-reference issues with PRs
- Connect Notion — Add strategy docs
- View Integrations — See all available integrations