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

# Linear

> Connect Linear so you can mention Linear issues directly in your messages when launching agents.

Linear integration is two steps: connect once per user, then link a specific Linear team to each Hideout project. Once linked, mention Linear issues directly in the New Agent chat.

<Note>
  **Where:** Platform → **Profile → Integrations** for the account connection, then **Project Settings → Integrations** to link a team.
</Note>

## 1. Connect Linear (account-level)

Profile → Integrations → **Connect Linear**. You'll be sent to linear.app to authorize the workspace, then dropped back on Project Settings with a "Connected" badge.

## 2. Link a Linear team (per Hideout project)

On Project Settings → Integrations, the Linear card lists every team visible to your account. Pick one. You can also optionally pick a project within that team to narrow the imported issue set.

## What you get

In the [New Agent](/guide/run-agents) chat, type a Linear identifier (e.g. `ROO-1163`) anywhere in your message. Seb pulls in the issue's title and description as context and tags the launch with it.

Issues resolve on demand at agent-launch time, against live Linear.

## Disconnecting

**Profile → Integrations → Linear → Disconnect** clears tokens. Projects you own that linked to a Linear team lose the link; teammates' links survive until they disconnect themselves.

## Troubleshooting

* **"Linear connection expired"** — your credentials were revoked or rotated. Linear connections don't auto-refresh, so this always means reconnecting from Profile.
* **Team picker is empty** — your Linear account doesn't have access to any teams. Check workspace permissions.
* **"Couldn't find ticket ROO-1163"** — the identifier doesn't exist in the linked Linear team, or your account doesn't have permission to see it. Check the team link on Project Settings → Integrations.
