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

# Linear clone

> Test Linear agents against a stateful clone of issues, projects, cycles, and initiatives that mirrors the official Linear MCP server tools.

Clone ID: `linear`

Covers issues, projects, cycles, and initiatives. All tools use the `linear_` prefix matching the real Linear MCP server.

## Start here

| Question     | Answer                                                                                                                      |
| ------------ | --------------------------------------------------------------------------------------------------------------------------- |
| Best for     | Agents that plan work, groom backlogs, update issue metadata, manage cycles, or connect issues to projects and initiatives. |
| Connect with | Route mode for `api.linear.app`, direct API base URLs from `archal clone start linear`, or MCP tools.                       |
| Known limits | The clone focuses on GraphQL-style product workflows, not Linear's web UI.                                                  |
| Seeds        | Common seeds: `small-team`, `engineering-org`, `busy-backlog`, `multi-team`, `empty`. See [Seeds](/guides/seeds) for usage. |

## Available tools

### Organization & Users

| Tool                     | Description                                            |
| ------------------------ | ------------------------------------------------------ |
| `linear_getViewer`       | Get information about the currently authenticated user |
| `linear_getOrganization` | Get information about the current Linear organization  |
| `linear_getUsers`        | Get a list of users in the organization                |

### Teams & Labels

| Tool                       | Description                    |
| -------------------------- | ------------------------------ |
| `linear_getTeams`          | Get a list of teams            |
| `linear_getLabels`         | Get a list of issue labels     |
| `linear_getWorkflowStates` | Get workflow states for a team |

### Issues

| Tool                           | Description                                                   |
| ------------------------------ | ------------------------------------------------------------- |
| `linear_getIssues`             | Get a list of recent issues                                   |
| `linear_getIssueById`          | Get a specific issue by ID or identifier (e.g., ABC-123)      |
| `linear_searchIssues`          | Search for issues with various filters                        |
| `linear_createIssue`           | Create a new issue                                            |
| `linear_updateIssue`           | Update an existing issue                                      |
| `linear_assignIssue`           | Assign an issue to a user                                     |
| `linear_setIssuePriority`      | Set the priority of an issue                                  |
| `linear_addIssueLabel`         | Add a label to an issue                                       |
| `linear_removeIssueLabel`      | Remove a label from an issue                                  |
| `linear_archiveIssue`          | Archive an issue                                              |
| `linear_duplicateIssue`        | Duplicate an issue                                            |
| `linear_getIssueHistory`       | Get the history of changes made to an issue                   |
| `linear_transferIssue`         | Transfer an issue to another team                             |
| `linear_convertIssueToSubtask` | Convert an issue to a subtask                                 |
| `linear_subscribeToIssue`      | Subscribe to issue updates                                    |
| `linear_createIssueRelation`   | Create relations between issues (blocks, is blocked by, etc.) |
| `linear_addIssueToProject`     | Add an existing issue to a project                            |
| `linear_addIssueToCycle`       | Add an issue to a cycle                                       |

### Comments

| Tool                   | Description                                           |
| ---------------------- | ----------------------------------------------------- |
| `linear_createComment` | Add a comment to an issue (supports threaded replies) |
| `linear_getComments`   | Get all comments for an issue                         |

### Projects

| Tool                      | Description                              |
| ------------------------- | ---------------------------------------- |
| `linear_getProjects`      | Get a list of projects                   |
| `linear_createProject`    | Create a new project                     |
| `linear_updateProject`    | Update an existing project               |
| `linear_getProjectIssues` | Get all issues associated with a project |

### Cycles

| Tool                    | Description                               |
| ----------------------- | ----------------------------------------- |
| `linear_getCycles`      | Get a list of all cycles                  |
| `linear_getActiveCycle` | Get the currently active cycle for a team |

### Initiatives

| Tool                                 | Description                                    |
| ------------------------------------ | ---------------------------------------------- |
| `linear_getInitiatives`              | Get a list of all initiatives                  |
| `linear_getInitiativeById`           | Get details of a specific initiative by ID     |
| `linear_createInitiative`            | Create a new initiative                        |
| `linear_updateInitiative`            | Update an existing initiative                  |
| `linear_archiveInitiative`           | Archive an initiative                          |
| `linear_unarchiveInitiative`         | Unarchive an initiative                        |
| `linear_deleteInitiative`            | Delete an initiative (move to trash)           |
| `linear_getInitiativeProjects`       | Get all projects associated with an initiative |
| `linear_addProjectToInitiative`      | Add a project to an initiative                 |
| `linear_removeProjectFromInitiative` | Remove a project from an initiative            |