Use Linear in Chat and Automations

Linear is the connector Agent0 uses to look up issues, projects, and teams from within Dash0. When an investigation surfaces a known bug, a feature being worked on, or a relevant incident, Agent0 can find the corresponding Linear context — or help you understand what's already being tracked.

Agent0 uses Linear interactively during Chat investigations and programmatically in Automations workflows. You never call Linear APIs yourself — Agent0 handles all lookups and references.

What Agent0 Uses Linear For

Once connected, Agent0 uses Linear to connect observability data to engineering work:

• Look up issues — find bugs, incidents, or tasks by keyword, team, or project
• Read issue details — status, assignee, priority, description, and comments
• Browse teams and projects — understand how work is organized across the engineering org
• Link telemetry to issues — identify the Linear issue that corresponds to a firing alert or error pattern

Use Linear in Chat

In Agent0 Chat, Linear appears as a set of tools Agent0 can use during investigations. You ask questions in natural language, and Agent0 decides when to query Linear.

How It Works

When you're investigating an issue in Chat, Agent0 can reference Linear to:

• Check if a bug is already tracked
• Find who owns a service or feature
• Understand what work is in progress
• Link production errors to existing tickets

Agent0 uses Linear tools automatically based on your questions. You don't need to know which Linear API to call or what parameters to pass — Agent0 handles that.

Example Chat Requests

What You See in Chat

When Agent0 uses Linear tools, you see:

• Tool calls — Agent0 shows which Linear tools it's using (e.g., "Searching Linear issues...")
• Results summary — Agent0 summarizes what it found (e.g., "Found 3 open issues for the payments team")
• Issue references — Links to Linear issues in Agent0's response
• Context synthesis — Agent0 connects Linear context to your observability data

Use Linear in Automations

In Automations, Agent0 can use Linear tools as part of event-driven workflows. Automations run automatically based on triggers (failed checks, high error rates, new incidents), and can query Linear programmatically as part of the response.

How It Works

Automations can:

• Search for related issues — when a check fails, find existing Linear bugs for that service
• Reference issue context — include Linear issue details in automation responses
• Link telemetry to issues — identify which Linear issues correspond to observed errors
• Enrich incident responses — pull team ownership and priority from Linear

Agent0 uses Linear tools within the automation prompt. You define what Agent0 should look for in the prompt, and Agent0 queries Linear as part of the automation workflow.

Example Automation Use Cases

Failed check references existing issues:

• Trigger: Check rule fails for "checkout-service"
• Agent0 action: Searches Linear for open issues mentioning "checkout-service"
• Response: Posts Slack message with check details and links to 2 related Linear issues

Incident response with issue context:

• Trigger: Error rate exceeds threshold
• Agent0 action: Searches Linear for issues matching the error message
• Response: Creates investigation with error logs, metrics, and links to the relevant Linear ticket

Team ownership lookup:

• Trigger: New service appears with degraded health
• Agent0 action: Searches Linear projects to identify team ownership
• Response: Routes alert to correct team based on Linear project ownership

Configuration

To use Linear in Automations:

1. Enable Linear connector in Settings → Integrations
2. Reference Linear in automation prompts — describe what Agent0 should query
3. Agent0 uses Linear tools automatically based on the prompt

Example automation prompt that uses Linear:

123
When this check fails, search Linear for open issues 
related to the affected service. Include issue links 
in the Slack notification.

Agent0 parses this prompt and knows to:

1. Extract service name from check metadata
2. Search Linear issues by service name
3. Include issue links in the response

Available Linear Tools

Agent0 has access to the following Linear tools when the connector is enabled:

• Search issues — find issues by keyword, status, team, or project
• Get issue details — fetch full issue information including description, comments, and metadata
• List teams — browse Linear teams and their members
• List projects — browse Linear projects and their status
• Search by service — find issues related to a specific service or component

You don't invoke these tools directly. Agent0 decides which tools to use based on your questions in Chat or automation prompts.

Access and Permissions

Agent0 uses read-only access to your Linear workspace when querying from Chat or Automations. It reads issues, projects, and team structures.

Who Can Use Linear in Chat

Any Dash0 user with access to Agent0 Chat can ask questions that trigger Linear queries. The Dash0 organization admin controls which Linear workspace is connected.

Who Can Use Linear in Automations

Automations that reference Linear tools run with the permissions of the connected Linear integration. Configure automation access in Settings → Integrations.

Further Reading

• Set Up Linear Integration — Configure the Linear connector and OAuth
• Use the Dash0 Linear Agent — Trigger Agent0 from Linear with @Dash0
• About Automations — Create event-driven AI workflows
• Investigation & Analysis — How Agent0 uses tools during investigations
• Key Concepts — Reference terminology and mental model