Linear

Connect Linear as your primary data source for issue research and specification enrichment.

Linear is the primary data source for SpecSource. It reads your issues and enriches them with detailed specifications.

Connecting

Go to Connectors → Add Connector → Linear.

OAuth (recommended): Click "Connect with OAuth" and authorize in Linear. The OAuth flow requests admin permissions solely for webhook registration — admin access is not used for anything else.

API Key: Paste a Linear API key from your Linear settings.

Trigger modes

By default, SpecSource uses polling to check for new Linear issues every 5 minutes. You can switch to webhook mode for near-instant detection from the trigger settings in the Agent Runs page. See Trigger Modes for details.

What happens

When an agent run executes, SpecSource:

  1. Reads your issues — Picks up new or selected Linear issues to research.
  2. Checks for duplicates — Uses semantic matching to find related existing issues. If a match is found, it links to the existing issue instead of creating a duplicate specification.
  3. Enriches the issue — A detailed specification is written back to the Linear issue with all the gathered context (root cause analysis, code, discussions, recommended fix).

The specification includes the issue summary, root cause analysis, relevant code files, related PRs, and any Slack discussions — everything a developer needs to start fixing.