Linear Integration (Native)

Orchestra now uses a high-performance native tracker for Linear. Do not use raw GraphQL tools.

🛠️ Primary Tools

Use the following system tools to interact with Linear issues:

1. tracker_query:

   • Use Case: Search for issues, fetch specific issue details, or list issues in a specific state.
   • Identifier: Always use the human-readable identifier (e.g., MT-123).

2. update_issue:

   • Use Case: Change the state, priority, or assignee of a Linear issue.
   • Audit logging: Changes are automatically recorded in the "Activity" history.

🔄 Common Workflows

Querying an Issue

To get the full context of an issue, including its current state and history:

json
1{
2  "tool": "tracker_query",
3  "arguments": {
4    "identifier": "PROJECT-123"
5  }
6}

Changing Issue State

To move an issue along the workflow (e.g., to "In Progress" or "In Review"):

json
1{
2  "tool": "update_issue",
3  "arguments": {
4    "identifier": "PROJECT-123",
5    "state": "In Progress"
6  }
7}

Finding Project Workspaces

To find issues related to a specific project or state:

json
1{
2  "tool": "tracker_query",
3  "arguments": {
4    "state": "Todo"
5  }
6}

📜 Usage Rules

• Zero GraphQL: Do not attempt to use linear_graphql. It has been removed.
• State Names: Use standard Linear state names (e.g., Todo, In Progress, Done, Canceled).
• Identifiers: Always prefer the ticket identifier (e.g., MT-1) over internal database IDs.
• Activity: Remember that every update_issue call creates a transparent audit trail visible to the user in the Activity tab.