> For the complete documentation index, see [llms.txt](https://docs.currents.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.currents.dev/resources/integrations/linear/setup.md).

# Setup

## Requirements

You need:

* A Linear workspace
* Currents organization admin permissions

## Architecture

| Scope        | Behavior                                                  |
| ------------ | --------------------------------------------------------- |
| Organization | One Linear workspace connection per Currents organization |
| Project      | Enable or disable the integration per Currents project    |

Multiple Currents projects can share the same workspace connection.

## Connect your workspace

1. In Currents, go to **Project > Integrations**
2. Select **Linear App**, then **Add Integration**
3. Click **Connect Linear App**
4. Approve the OAuth request in Linear
5. Return to Currents and confirm the workspace appears as connected

<figure><img src="/files/O2PznsfxgdMMtijmTtWQ" alt="Connect Linear App button" width="400"><figcaption><p>Starting the OAuth connection</p></figcaption></figure>

{% hint style="info" %}
Only organization admins can connect, disconnect, or change settings. Other members can view connection status.
{% endhint %}

## Enable for a project

After the workspace is connected, turn the integration on for each project that should use it:

1. Open **Project > Integrations > Linear App**
2. If prompted, click **Enable for this project**
3. Turn on **Enable Linear Integration**
4. Click **Save Configuration**

If the workspace is already connected at the organization level, you can enable the current project without repeating OAuth.

{% hint style="success" %}
**You're all set.** After connecting and enabling the integration for your project, the Linear workspace appears on the integration page.
{% endhint %}

## Disconnect

Organization admins can remove the workspace connection from **Project > Integrations > Linear App**:

1. Click **Disconnect**
2. Confirm

This revokes Linear permissions and disables the integration for every project that used the connection.

## Reconnect after disconnect

If you disconnected the integration and want to connect the same workspace again:

1. Go to **Project > Integrations > Linear App**
2. Click **Re-authenticate**
3. Approve the OAuth request in Linear

Per-project settings are preserved when you reconnect.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.currents.dev/resources/integrations/linear/setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.