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.

Setting Up Linear Integration

Prerequisite

You must add Linear as an integration in your Paradime Settings for the Linear Tool to work properly.

Step 1: Gather Your Linear Information

1. Go to Linear (https://linear.app)

2. From your homepage, navigate to your username on the top-left corner and click Workspace settings.

3. Within the narrow Settings column, click API

4. Select Create new API key

5. Store the key in a secure location

Step 2: Configure in Paradime

1. Go to Settings

2. Within the Settings column, click Environment Variables

3. In the Code IDE section, click + Add New (N)

4. In Enter key field, give your key a practical name (e.g., "LINEAR_API_KEY")

5. In Enter value field, paste Linear API Key from Step 1

---

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. Select the Linear tool from the tools menu

3. Enter the Linear issue ID or URL you want to reference (e.g., "A-123" or a full Linear Issue URL)

4. Add your prompt describing what you want DinoAI to do with the issue information

5. Grant permission when DinoAI asks to access the Linear issue

6. Review and implement DinoAI's suggested actions

Example Use Cases

Summarizing Documentation

• Prompt: "I need to implement the feature described in A-456. Can you help me get started?"

• 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.

Extracting Information

• 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 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 Git Branches

The Linear Tool works seamlessly with DinoAI's Terminal capabilities to:

1. Create branches using standard linear-based naming conventions (e.g., feature/linear-123)

2. Reference issue IDs in commit messages

3. Track changes back to specific requirements or issues

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

---

Best Practices

1. Use clear ticket references - Include the exact Linear issue key or URL in your prompt

2. Ensure ticket quality - DinoAI works best with well-documented Linear issues that include clear descriptions

3. Verify suggestions - Always review DinoAI's interpretation of requirements before implementing

4. Combine with Terminal tool - Let DinoAI help with the full workflow of issue from implementation to testing