Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mains.dev/llms.txt

Use this file to discover all available pages before exploring further.

The Linear integration syncs issues from your selected teams into Mains’s entity store. Linear issues — with their identifiers like ABC-123 — become searchable locally and available as context in AI chat.

​
Authentication

Linear uses an API key for authentication. You can generate a personal API key from your Linear account settings. The key is stored encrypted in the local database.
Mains uses the @linear/sdk package to communicate with the Linear API, providing typed access to issues, teams, labels, and other resources.

​
Setup

1

Generate an API Key

In Linear, go to Settings > API and create a new personal API key.
2

Connect Linear

Go to Settings > Apps in Mains and click Connect next to Linear. Paste your API key when prompted.
3

Select Teams

Choose which Linear teams to sync. Only issues from selected teams will be fetched.
4

Initial Sync

Mains will perform an initial sync to fetch existing issues.