# Linear integration

Canonical HTML: https://getdispatcher.dev/help/linear

## What you get

- Import Linear issues and projects into Dispatcher as tasks on your board
- Keep planning context next to local agent execution
- Run agents on imported work without leaving the Dispatcher loop

## Connect Linear

1. Open Dispatcher
2. Go to **Settings → Integrations**
3. Choose **Linear** and complete the OAuth flow
4. Select the team whose issues you want to import

## Import work

1. In **Settings → Integrations → Linear**, pick a team
2. Click **Import all projects & issues**
3. Imported items appear on your Dispatcher board (or local tasks if Local-only mode is on)
4. Open a task, attach context, then execute with an agent

Re-importing the same Linear issues updates existing tasks (matched by Linear id) instead of duplicating them.

## Tips

- Re-connect Linear from Settings if imports suddenly fail (expired OAuth)
- Keep the “definition of done” in the task before launching an agent
- Dispatcher does not replace Linear; it helps execute work that starts there

## Related

- [Integrations overview](https://getdispatcher.dev/help/integrations)
- [Agents & harnesses](https://getdispatcher.dev/help/agents)