Agent SDK

Appearance

Triage Linear or Jira issues in place ​

This agent comments on tickets you already filed. It classifies the issue, writes a Triage: comment, sets bug priority, and links a duplicate when titles match.

File the ticket however you already do. This template starts after the ticket exists.

Scaffold ​

bash
npx @cursor/july init ./triage-agent --template triage-linear
npx @cursor/july init ./triage-agent --template triage-jira

Pick the tracker you use. The agent is the same. The overlay is the connection.

init writes the project, installs dependencies, and puts agent-sdk on PATH.

Log in ​

Model turns and Cursor MCP use your Cursor account.

bash
cd triage-agent
agent-sdk login

The command opens a browser if you have no stored credential.

Connect the tracker ​

In the Cursor dashboard, open MCP and connect Linear or Jira.

The connection stays on the host. The model calls record_triage. Linear and Jira tools stay off the model's tool list.

First verdict ​

bash
agent-sdk dev

Open the playground. Run /queue/issue and paste an existing issue.

Local multi-agent mode mounts this project as triage-agent. You can also POST:

bash
curl -X POST http://127.0.0.1:3000/triage-agent/v1/channels/queue/issue \
  -H 'content-type: application/json' \
  -d '{
    "identifier": "ENG-142",
    "title": "CSV export returns 500",
    "description": "Export has returned 500 since this morning."
  }'

POST /v1/channels/queue/issue accepts { identifier, title?, description? } from the playground.

Hosted Cursor aliases require X-Agent-Alias-Token, which Linear and Jira cannot send. For create webhooks, self-host, set LINEAR_WEBHOOK_SECRET or JIRA_WEBHOOK_SECRET, and POST the signed body to /v1/channels/webhook. The channel ACKs immediately and coalesces retries onto the same issue.

record_triage comments on the issue in the continuation key, not whatever identifier the model copies out of the ticket body.

Rubric ​

Edit agent/skills/triage-rubric.md for kinds, tie-breakers, and what urgent means on your team. The next turn reads the file.

agent/instructions.md is the procedure around the rubric: missing details, when to call record_triage, how to reply.

Evals ​

Three smoke cases, one per kind. Run them after you change the rubric.

bash
agent-sdk eval

Eval sessions skip tracker writes.

Deploy ​

bash
agent-sdk deploy

Run it from the agent's git checkout. It infers repository, ref, path, and slug, builds on Cursor-managed hosting, and prints the URL. agent-sdk deployments shows status.