# Linear Tool

## Linear Tool

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.

{% hint style="info" icon="plug-circle-plus" %}
**Requires Linear integration.** Before using this tool, make sure you've connected your Linear account in Paradime. See [Connecting Linear](https://docs.paradime.io/app-help/documentation/integrations/code-ide/linear) to Paradime for setup instructions.
{% endhint %}

### Capabilities

| Capability                    | What It Does                                              |
| ----------------------------- | --------------------------------------------------------- |
| **Access Issue Information**  | Fetch details from Linear issues using issue keys or URLs |
| **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

1. Open DinoAI in the right panel of the Code IDE
2. Enter the Linear issue ID or URL you want to reference (e.g., `A-123` or a full Linear issue URL)
3. Add your prompt describing what you want DinoAI to do with the issue information
4. Grant permission when DinoAI asks to access the Linear issue
5. Review and implement DinoAI's suggested actions

<div data-with-frame="true"><figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2FXhlvb1gG6YA8cz3GyB0h%2Flinear.png?alt=media&#x26;token=915f56da-2ad3-46d3-9027-744896ba26fe" alt=""><figcaption></figcaption></figure></div>

### Example Use Cases

#### Implementing a Feature from an Issue

**Prompt**

{% code overflow="wrap" %}

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

{% endcode %}

**Result:** DinoAI extracts requirements from the Linear issue, suggests an implementation approach, and helps create the necessary models or code changes to satisfy the requirements.

#### Resolving a Production Issue

**Prompt**

{% code overflow="wrap" %}

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

{% endcode %}

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

### 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


---

# Agent Instructions: 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:

```
GET https://docs.paradime.io/app-help/documentation/dino-ai/tools-and-features/linear-tool.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.