> For the complete documentation index, see [llms.txt](https://whitepaper.aitech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.aitech.io/agentforge/tools/linear.md).

# linear

[Linear](https://linear.app/) is a leading project management and issue tracking platform that helps teams plan, track, and manage their work effectively. As a modern project management tool, Linear has become increasingly popular among software development teams and project management professionals for its streamlined interface and powerful features.

Linear provides a comprehensive set of tools for managing complex projects through its flexible and customizable workflow system. With its robust API and integration capabilities, Linear enables teams to streamline their development processes and maintain clear visibility of project progress.

Key features of Linear include:

* Agile Project Management: Support for Scrum and Kanban methodologies with customizable boards and workflows
* Issue Tracking: Sophisticated tracking system for bugs, stories, epics, and tasks with detailed reporting
* Workflow Automation: Powerful automation rules to streamline repetitive tasks and processes
* Advanced Search: Complex filtering and reporting capabilities for efficient issue management

In Agent Forge, the Linear integration allows your agents to seamlessly interact with your project management workflow. This creates opportunities for automated issue creation, updates, and tracking as part of your AI workflows. The integration enables agents to read existing issues and create new ones programmatically, facilitating automated project management tasks and ensuring that important information is properly tracked and documented. By connecting Agent Forge with Linear, you can build intelligent agents that maintain project visibility while automating routine project management tasks, enhancing team productivity and ensuring consistent project tracking.

### Usage Instructions

Integrate with Linear to fetch, filter, and create issues directly from your workflow.

### Tools

#### `linear_read_issues`

Fetch and filter issues from Linear

**Input**

| Parameter   | Type   | Required | Description       |
| ----------- | ------ | -------- | ----------------- |
| `teamId`    | string | Yes      | Linear team ID    |
| `projectId` | string | Yes      | Linear project ID |

**Output**

| Parameter | Type | Description       |
| --------- | ---- | ----------------- |
| `issues`  | json | Issues list       |
| `issue`   | json | Single issue data |

#### `linear_create_issue`

Create a new issue in Linear

**Input**

| Parameter     | Type   | Required | Description       |
| ------------- | ------ | -------- | ----------------- |
| `teamId`      | string | Yes      | Linear team ID    |
| `projectId`   | string | Yes      | Linear project ID |
| `title`       | string | Yes      | Issue title       |
| `description` | string | No       | Issue description |

**Output**

| Parameter | Type | Description       |
| --------- | ---- | ----------------- |
| `issues`  | json | Issues list       |
| `issue`   | json | Single issue data |

### Notes

* Category: `tools`
* Type: `linear`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://whitepaper.aitech.io/agentforge/tools/linear.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.