Skip to main content

​
Overview

TierZero can be installed as a Linear agent — an assignable, mentionable member of your Linear workspace. Once installed, any issue assigned to TierZero (or comment that @mentions it) opens an agent session in Linear’s UI. TierZero acknowledges within seconds, streams its thinking and tool calls back as activities, and posts a final response when it’s done. A Linear issue activity feed: TierZero is assigned the issue, completes an investigation with root cause, and starts drafting a fix PR after a follow-up message Linear is treated as a new channel for the existing Support Agent product. Issues that match a Support Agent’s routing rules run that agent’s runbook; everything else falls through to a generic ad-hoc chat session — same as @mentioning TierZero in Slack.

​
Prerequisites

  • Administrative access to your Linear workspace (required to install the agent)
  • Admin role in TierZero with write:integrations permission

​
Setup Instructions

​
Step 1: Install the Agent in Your Workspace

  1. In TierZero, go to Settings → Integrations → Project Management → Linear
  2. Open the Agent tab
  3. Click Install Agent
  4. You’ll be redirected to Linear to authorize the installation
  5. Approve the requested permissions (assignable, mentionable, post agent activities)
  6. You’ll be redirected back to TierZero with the installation listed under the Agent tab
After installation, TierZero appears as a member of your Linear workspace. It can be assigned to issues, mentioned in comments, and added to teams just like a human user. The agent does not consume a billable Linear seat. You can install the agent into multiple Linear workspaces from the same TierZero org — each workspace shows up as its own row in the Agent tab.

​
Step 2: Route Issues to TierZero (Linear Side)

This step happens entirely in Linear and is up to you. Common patterns:
  • Manual assignment: Engineers assign individual issues to TierZero as needed
  • Linear automations: Auto-assign issues that match conditions (e.g. “when issue created in Security team → delegate to TierZero”)
  • Labels or dedicated projects: Route issues via a tierzero label or a dedicated project
TierZero is passive — it processes whatever is assigned or @mentioned. How issues arrive is your choice.

​
Step 3: Configure a Support Agent for Linear (Optional)

To run a specific runbook on issues that match certain criteria, create a Support Agent with Linear as the source:
  1. Go to Support Agents → Create Support Agent
  2. Choose Linear as the source
  3. Pick the Linear team this agent should monitor
  4. (Optional) Add filter rules — match by labels and/or project. Rules support AND/OR logic.
  5. Write filtering instructions / runbook
  6. Save
Issues assigned to TierZero in the chosen team that pass the filter will run this Support Agent’s runbook. Issues that match no Support Agent fall through to a generic ad-hoc chat session — full tool access, no runbook.
Each Linear team can be bound to at most one Support Agent. Use filter rules within that agent if you need to differentiate behavior by label or project inside the same team.

​
Removing the Agent

Removing the agent is a two-sided action — disconnect on the TierZero side, then revoke access on the Linear side.

​
Step 1: Disconnect on TierZero

  1. Settings → Integrations → Linear → Agent tab
  2. Click the menu next to the workspace and choose Disconnect
This removes the OAuth credentials and stops TierZero from processing webhooks for that workspace.

​
Step 2: Revoke Access in Linear

  1. In Linear, go to Settings → API → Authorized applications
  2. Find the TierZero agent and click Revoke
Until access is revoked in Linear, the TierZero agent will still appear as an installed application in your workspace.