Linear is a project management tool built for software teams. It lets your RShift Sites app work with issues, projects, teams, cycles, and comments so you can build internal tools and automations that interact directly with your team’s Linear workspace.
| Use | If you want to |
|---|---|
| App + chat connector (this page) | Work with a shared Linear connection in the project chat and in your published apps |
| Chat connector (MCP server) | Let RShift Sites read your own Linear account as context while you build, personal to you |
| App user connector | Let each user of your published app connect their own Linear account and work with their own data |
With Linear, your app can:
- Create and update issues and comments
- Read team, project, and cycle data
- Build dashboards that surface issue status and progress
- Automate triage, reporting, and planning workflows
Linear is a good fit when your app needs to work with engineering tasks, product planning, or issue tracking directly from your app interface.
Common use cases and example apps
| Example app | Example prompt | Description |
|---|---|---|
| Bug reporting form | Build an internal bug reporter that creates a Linear issue when a user submits a report. | Let users file bugs directly into Linear from your app. The app captures the submission and creates a properly formatted Linear issue in the right team queue, with no manual copy-paste required. |
| Sprint dashboard | Build a sprint dashboard that shows open issues by team and status, grouped by cycle. | Give your team a live view of sprint progress without leaving your app. The app reads current cycle data from Linear and displays issues by status, assignee, or priority. |
| Feature request intake | Build a product request intake form. When someone submits a request, create a Linear issue in the triage backlog. | Turn form submissions into structured Linear issues automatically. The app routes incoming requests directly into your Linear backlog so nothing falls through the cracks. |
| Issue triage workspace | Build an internal triage workspace that shows new Linear issues, lets me filter by team and priority, and update status from one view. | Help teams review and manage incoming work more efficiently. The app reads issues from Linear, organizes them into a focused triage interface, and lets users update priorities or statuses without switching tools. |
| Project health dashboard | Build a project health dashboard that pulls issue counts, completion rates, and blockers from Linear. | Combine Linear data with your app’s context in a single internal view. The app reads project and cycle metrics from Linear and surfaces them alongside other operational data. |
How Linear connections work
Each Linear connection is authorized for a single Linear workspace. When you connect Linear, you authorize RShift Sites to access Linear on behalf of the authenticated account.
Within your RShift Sites workspace:
- You can create multiple Linear connections.
- Each connection is a separate OAuth authorization.
- Each connection can:
- Use different scopes
- Connect to a different Linear workspace
- Multiple projects within a single workspace can use the same connection.
This makes it easy to separate environments (for example, development and production) or manage multiple Linear workspaces.
Linear uses RShift Sites’ gateway architecture for secure OAuth handling and automatic token refresh. See Gateway-based connectors for details on authentication and usage limits.
How to connect Linear
Workspace admins and owners can connect Linear.
When a connection is created, Linear becomes available across all projects in the workspace.
Prerequisites
Before connecting Linear, make sure you have:
- A Linear account you can authorize via OAuth
- RShift Sites workspace admin or owner role
Set up your Linear connection
Navigate to the Linear connector
Open Connectors and select Linear.
Add a new connection
Click Add connection.
Name the connection
In Display name, enter a name for the connection, for example Linear (Prod).
Configure scopes (optional)
Expand Advanced settings to review or adjust the requested OAuth scopes - the Linear permissions your app needs. Read and Write are selected by default and cover the most common use cases.
Connect to Linear and authorize the connection
- Click Connect. The Linear authorization window opens, so make sure your browser does not block pop-ups.
- Select the workspace you want to connect, review the requested permissions, and click Allow. You’ll be redirected back to RShift Sites with a confirmation.
When connected, your RShift Sites apps can start using Linear data.
Limitations
The Linear connector does not support:
- Receiving incoming Linear webhooks or real-time event subscriptions.
Manage your {connector_0} connection
Connections are managed from Connectors: select {connector_0}, then open the connection.
- Unlink projects to remove {connector_0} access from specific projects while keeping the connection available for others. See Unlink projects from a connection for the steps.
- Delete the connection to remove it from the workspace entirely. Deleting is permanent. It removes the credentials from all linked projects, and app features that use {connector_0} stop working until a new connection is added. See Delete a connection for the steps and who can delete.