> ## Documentation Index
> Fetch the complete documentation index at: https://docs.niteshift.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Link Linear issues to Niteshift tasks for automatic status transitions, progress comments, and PR attachments.

Link Linear issues to Niteshift tasks for automated progress updates, PR attachment, and status
transitions on the issue.

## Setup

<Steps>
  <Step title="Connect Linear">
    Open **Settings → Integrations → Linear** and click **Connect**. The OAuth flow links your Linear workspace to Niteshift.
  </Step>

  <Step title="Choose teams">
    Pick which Linear teams should have Niteshift available. Issues in other teams are ignored.
  </Step>

  <Step title="Set a default repository">
    Each user sets a default repository for Linear-triggered tasks under the same settings panel. Without it, assignment-triggered tasks fail with a prompt to configure one.
  </Step>
</Steps>

## How to use

Two paths trigger a Niteshift task from Linear:

**Assign a Linear issue to Niteshift.** Niteshift creates a task in your default repository. The
issue title, description, recent comments, and up to 5 images are passed in the agent prompt. If the
agent needs more context (sub-issues, parent issues, additional comments or images, related tickets,
etc.), configure the [Linear MCP server](/customizing-agents/mcp).

**Tag `@Niteshift` in a Linear comment.** Use this when you want to add a specific instruction
beyond what's already in the ticket. The comment body becomes the prompt; the rest of the issue
context loads the same way as an assignment.

<Note>
  Follow-up prompts in Linear work until a prompt arrives from another source (web UI, GitHub) —
  after that, send follow-ups from the web UI.
</Note>

## What you receive

When a task is linked to an issue, Niteshift:

* Moves the issue to **In Progress** when the task starts
* Moves it to **In Review** when the task completes
* Posts agent thoughts, summaries, and PR links as Linear comments
* Attaches the pull request to the issue

Image attachments in the issue description and recent comments (anything hosted at
`uploads.linear.app`) are downloaded into the task so the agent can see them.

<Tip>
  This is the issue-tracker integration. Separately, the [Linear MCP
  server](/customizing-agents/mcp) lets agents read and write Linear data directly during a task,
  useful for "go check related tickets" or "update the parent issue when done" workflows.
</Tip>