> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paradime.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear Tool

> The Linear Tool connects DinoAI to your Linear issues, helping implement features and fix bugs based on requirements stored in your task management system

The Linear Tool allows DinoAI to access information from your Linear issues, bringing task requirements and issue details directly into your development workflow.

This tool connects development work to Linear, enabling DinoAI to understand requirements, resolve tickets, and implement features based on information stored in Linear.

<Info>
  **Requires Linear integration.** Before using this tool, make sure you've connected your Linear account in Paradime. See [Connecting Linear](/integrations/linear) to Paradime for setup instructions.
</Info>

#### Available tools

DinoAI exposes two Linear-specific tool calls. Both ask for permission before they run.

| Tool                   | What it does                                                                                                                                                                |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fetch Linear issue** | Fetches the full details of a single Linear issue by ID (e.g. `ENG-456`) — title, description, state, assignee, team, labels, branch name, child issues, and comments.      |
| **List Linear issues** | Lists Linear issues with optional filters: **team**, **assignee email**, **workflow state**, **label**, and **priority**. Use this to discover, triage, or batch-plan work. |

#### Capabilities

| Capability                    | What it does                                                                           |
| ----------------------------- | -------------------------------------------------------------------------------------- |
| **Fetch a specific issue**    | Pull details from a Linear issue using its key or URL                                  |
| **Discover issues by filter** | Find issues by team, assignee, state, label or priority — without knowing the exact ID |
| **Extract Requirements**      | Understand task requirements and acceptance criteria                                   |
| **Fix Reported Issues**       | Help resolve bugs and errors documented in issues                                      |
| **Track Work Implementation** | Associate code changes with specific Linear issues                                     |

#### Using the Linear Tool

Depending on whether you already know the issue ID, DinoAI will pick one of the two tools:

**When you reference a specific issue**

1. Open DinoAI in the right panel of the Code IDE
2. Mention the Linear issue ID or URL in your prompt (e.g. `ENG-456` or a full Linear issue URL)
3. Grant permission when DinoAI asks to access the Linear issue — this runs **Fetch Linear issue**
4. Review and implement DinoAI's suggested actions

**When you want DinoAI to find issues for you**

1. Open DinoAI in the right panel of the Code IDE
2. Describe the issues you're after in natural language — e.g. "in-progress bugs assigned to me in the ENG team", "all P1 issues with the `data-quality` label", "issues in the `Triage` state for team DATA"
3. Grant permission when DinoAI asks to list issues — this runs **List Linear issues** with the filters DinoAI inferred from your prompt
4. From the returned list, DinoAI can then drill into a specific issue using **Fetch Linear issue**

<Info>
  **Supported filters for List Linear issues** — team key (e.g. `ENG`), assignee email, workflow state name (e.g. `In Progress`), label name, and Linear priority (`0` = None, `1` = Urgent, `2` = High, `3` = Medium, `4` = Low). Up to 100 issues are returned per call.
</Info>

#### Example Use Cases

**Implementing a Feature from an Issue**

**Prompt**

```
I need to implement the feature described in A-456. Can you help me get started?
```

**Result:** DinoAI calls **Fetch Linear issue** for `A-456`, extracts the requirements, suggests an implementation approach, and helps create the necessary models or code changes to satisfy them.

**Resolving a Production Issue**

**Prompt**

```
I have a production branch that failed this morning. Details are in Linear issue A-123. Can you help me resolve it?
```

**Result:** DinoAI fetches the issue details, analyses the error information, and walks you through creating a fix branch, updating the relevant files, and testing the solution.

**Triaging issues across the team**

**Prompt**

```
List all Urgent issues currently In Progress for team ENG, and tell me which ones look most likely to block this week's release.
```

**Result:** DinoAI calls **List Linear issues** with `team_key="ENG"`, `state_name="In Progress"`, `priority=1`, summarises the returned list, and highlights the issues most likely to block the release. From there, ask DinoAI to drill into a specific one to plan or implement the fix.

**Finding my open work**

**Prompt**

```
Show me all my open Linear issues with the "dbt" label, then pick the highest-priority one and start implementing.
```

**Result:** DinoAI lists issues filtered by `assignee_email` (you) and `label_name="dbt"`, picks the highest-priority one, fetches its full details, and starts the implementation plan.

#### Working with Other Tools

The Linear Tool works well alongside DinoAI's other capabilities to support your full development workflow:

* Combine with the **Terminal Tool** to create branches using Linear-based naming conventions (e.g., `feature/linear-123`) and reference issue IDs in commit messages
* Combine with the **Confluence Tool** to cross-reference issue requirements against linked specification pages
* Use alongside **Git Lite** to commit implementation work that traces back to a specific Linear issue

You'll need appropriate Linear permissions to access issues. DinoAI will request permission each time it needs to access Linear information.

#### Best Practices

* **Use exact issue references** — Include the precise Linear issue key or URL in your prompt to ensure DinoAI accesses the correct issue
* **Ensure issue quality** — DinoAI works best with well-documented Linear issues that include clear descriptions and acceptance criteria
* **Verify suggestions** — Always review DinoAI's interpretation of requirements before implementing, especially for complex or ambiguous issues
* **Combine with the Terminal Tool** — Let DinoAI help with the full workflow from implementation to testing, using the issue as the source of truth throughout


## Related topics

- [Linear](/integrations/linear.md)
- [Confluence Tool](/products/dino-ai/tools-and-features/confluence-tool.md)
- [Notion Tool](/products/dino-ai/tools-and-features/notion-tool.md)
- [Google Docs Tool](/products/dino-ai/tools-and-features/google-docs-tool.md)
- [GitHub PR Management Tool](/products/dino-ai/tools-and-features/github-pr-management-tool.md)