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

# Linear

> Turn Linear issues into scoped Roomote work.

The Linear integration lets Roomote receive work from Linear, post progress back to the issue or agent session, and keep the full run available in the Roomote task view.

Linear is optional during onboarding. Connect it when your team wants Roomote to work from issues that already have product context, acceptance criteria, priority, or discussion.

## Setup

<Steps>
  <Step title="Connect Linear">
    In Roomote, go to **Settings** and connect your Linear workspace. New admins
    may also see this as an optional step after the first environment setup task
    finishes.
  </Step>

  <Step title="Link your user account">
    Link your Linear identity when prompted so Roomote can associate issue
    activity with your Roomote user.
  </Step>

  <Step title="Make sure an environment exists">
    Roomote needs an environment that matches the repository or workspace the
    issue refers to.
  </Step>
</Steps>

## Starting work from Linear

You can start Roomote work from a Linear agent session or by mentioning Roomote on an issue. Roomote uses the issue context and may ask you to confirm the workspace before it launches.

Good Linear asks include:

* draft an implementation plan for this issue
* investigate whether this bug is reproducible
* implement the smallest fix that satisfies the acceptance criteria
* explain what code paths this issue touches
* open a PR and link it back to the issue

## Progress and follow-up

Roomote can post status, plan updates, and final responses back to Linear. The Roomote task view remains the best place to inspect logs, diffs, artifacts, and previews.

<Tip>
  Put acceptance criteria and relevant repository links directly in the Linear
  issue before starting agent work.
</Tip>