> ## Documentation Index
> Fetch the complete documentation index at: https://dhiwisepvtltd-5e04e6a4.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Connect Linear to Rocket and build from your tickets. Rocket reads descriptions, acceptance criteria, and briefs, then writes follow-up tickets back.

Point Rocket at a Linear ticket and it builds the feature. No copy-pasting requirements, no manually updating your board.

Rocket reads your issue descriptions, acceptance criteria, and project briefs directly from Linear. When the build is done, it writes follow-up tickets and status updates back.

## What you can do

> **Build from a ticket**
>
> Paste a Linear issue URL into chat. Rocket reads the title, description, and acceptance criteria, then generates the implementation.

> **Build from a project**
>
> Paste a Linear project URL. Rocket reads all child issues and the project brief, then builds the full scope.

> **Fix bugs from reports**
>
> Paste a bug ticket URL. Rocket reads the screen name, expected vs actual behavior, and generates a targeted fix.

> **Use ticket copy in your app**
>
> Pull feature descriptions and value propositions from a ticket directly into your app's UI copy.

> **Create follow-up tickets**
>
> After building, ask Rocket to create QA tickets, edge case tickets, and testing tasks back in Linear.

> **Auto-update ticket status**
>
> Ask Rocket to move the original ticket to Done and leave an implementation comment when the build finishes.

## Connect Linear

Linear uses OAuth, so no API key is needed. It is a **workspace-level** connector, so connect it once and it is available across all tasks.

**Web Browser**

You can connect from three places. All do the same thing.

**Option 1: From chat**

Paste a ticket URL or ask Rocket to create issues. Rocket detects the intent and shows a **Connect** button inline. Click it to open the authorization flow.

![Rocket chat panel showing a Connect prompt for Linear.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/linear/web-browser/linear-chat-light.webp)

![Rocket chat panel showing a Connect prompt for Linear.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/linear/web-browser/linear-chat-dark.webp)

Linear connection prompt in chat

**Option 2: From the Connectors tab**

Click the **`...`** button in the preview toolbar, then select **Connectors**.

Open Connectors from the toolbar

Click the **Linear** card, then click **Connect**.

![Connectors panel showing the Linear card with a Connect button.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/linear/web-browser/linear-connectors-tab-light.webp)

![Connectors panel showing the Linear card with a Connect button.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/linear/web-browser/linear-connectors-tab-dark.webp)

Linear card in the Connectors panel

**Option 3: From workspace Settings**

> **[Connect from workspace Settings](https://dhiwisepvtltd-5e04e6a4.mintlify.site/getting-started/workspace/connectors.md)**
>
> Connect once from Settings and it is available across all tasks.

**After clicking Connect**

A Linear authorization screen opens. Review the permissions and click **Authorize**.

![Linear OAuth screen showing Rocket requesting read and write access to your workspace.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/linear/oauth-authorize-light.webp)

![Linear OAuth screen showing Rocket requesting read and write access to your workspace.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/linear/oauth-authorize-dark.webp)

Linear OAuth authorization screen

A green dot appears next to Linear when the connection is active.

**Disconnect**

[Disconnect a service](https://dhiwisepvtltd-5e04e6a4.mintlify.site/getting-started/workspace/connectors.md#disconnect-a-service)

Disconnect or switch accounts from workspace Settings.

**Mobile App**

You can connect from two places. Both do the same thing.

**Option 1: From chat**

Paste a ticket URL or ask Rocket to create Linear issues. Rocket shows a **Connect** button inline. Tap it to open the authorization flow.

**Option 2: From the Connectors tab**

1. Tap the **More** button in the header.
2. Tap **Integrations**.
3. Tap the **Linear** card, then tap **Connect**.

**After tapping Connect**

A Linear authorization screen opens. Review the permissions and tap **Authorize**.

A green dot appears next to Linear when the connection is active.

## Example prompts

Replace `[LINEAR_URL]` with your actual issue or project URL.

### Reading from Linear

| What you want | Prompt to use |
| :- | :- |
| Build a feature from a ticket | `Build the feature described in [LINEAR_URL]. Read the full requirements, edge cases, and acceptance criteria before generating.` |
| Build from a full project | `Read the Linear project at [LINEAR_URL] and build the described UI including all screens referenced in the project brief.` |
| Fix a bug from a report | `Fix the bug described in [LINEAR_URL]. Read the screen name, expected behavior, and actual behavior and generate a targeted fix.` |
| Apply a requirement change | `The requirements changed in [LINEAR_URL]. Read the updated ticket and modify the relevant parts of the app.` |

### Writing back to Linear

| What you want | Prompt to use |
| :- | :- |
| Create QA tickets | `Create a Linear project with QA tickets for the checkout flow I just built. Include test cases based on the implementation.` |
| Log client change requests | `Create a Linear project with tickets for each client-requested change, organized by page and priority.` |
| Document what was built | `Create a Linear document describing what was built and link it to the original ticket at [LINEAR_URL].` |
| Create follow-up tasks | `Create Linear tickets for all the follow-up work from this build: enhancements, edge cases, and testing tasks.` |

## Tips

* **Be specific in your tickets.** Rocket builds from what is written. Tickets with detailed descriptions, clear acceptance criteria, and labels produce better output than vague ones.
* **Use issue URLs, not project names.** Pasting a direct URL gives Rocket unambiguous context. Referring to a project by name can match the wrong one.
* **For large workspaces, scope it down.** Reference a specific project or issue instead of asking Rocket to read the full workspace backlog.
* **Write-back creates real tickets.** When Rocket creates or updates Linear issues, they appear in your board immediately. Review them before sharing with your team.
* **Permissions apply.** Rocket respects Linear's access controls. It can only read and write what the connected account has permission to access.

## What's next?

> **[Notion](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/notion.md)**
>
> Connect your docs and wikis so Rocket builds with full product context.

> **[Google Workspace](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/google.md)**
>
> Read from Docs, Sheets, and Calendar to build context-rich apps.

> **[GitHub](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/github/overview.md)**
>
> Push your code to a repository and keep version history.

> **[All connectors](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/overview.md)**
>
> Browse every available integration.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.