What the integration does
| Feature | Description |
|---|---|
| Issue linking | Associate tasks with Linear issues |
| Status updates | Post agent thoughts and progress to Linear |
| PR attachments | Attach pull requests to Linear issues |
| State transitions | Move issues to “In Progress” or “In Review” |
How it works
When you create a task linked to a Linear issue:- Task starts — Linear issue moves to “In Progress”
- Agent works — Progress updates post to the Linear issue
- PR created — PR is attached to the Linear issue
- Task completes — Issue moves to “In Review”
Creating linked tasks
Include the Linear issue ID when creating a task:- From the dashboard, paste a Linear issue URL in the prompt
- The agent detects the issue and links automatically
Progress updates
The agent posts updates to Linear as it works:- Thoughts — What the agent is considering
- Responses — Summaries of completed work
- Screenshots — Visual progress on UI tasks
- Errors — Issues encountered during execution
Configuration
1
Connect Linear
Go to Settings → Integrations → Linear and click Connect.
2
Authorize
Authorize Niteshift to access your Linear workspace.
3
Select teams
Choose which Linear teams to enable for task linking.
Permissions required
Niteshift requests these Linear permissions:| Permission | Purpose |
|---|---|
| Read issues | Access issue details and context |
| Write comments | Post progress updates |
| Update issues | Change issue state |
| Create attachments | Link PRs to issues |
Linear integration is optional. Tasks work without it—you just won’t get automatic Linear updates.