agentskit.js
ToolsIntegrations

linearTriage

Linear triage — list a team's triage queue, assign owner / state / priority.

import { linearTriage } from '@agentskit/tools/integrations'

const tools = linearTriage({ apiKey: process.env.LINEAR_API_KEY! })

Bundled: linearTriage(config) returns both sub-tools. Sub-tools talk to Linear's GraphQL API at https://api.linear.app/graphql.

#Sub-tools

NamePurpose
linear_triage_listList issues currently in a team's triage state
linear_triage_assignMove a triage issue to a state, optionally assign and set priority

#Schema

#linear_triage_list

ParameterTypeRequiredDescription
teamIdstringyesLinear team ID
firstnumbernoMax issues to return (default 25)

#linear_triage_assign

ParameterTypeRequiredDescription
issueIdstringyesLinear issue ID
stateIdstringyesTarget workflow state ID (e.g. Backlog, Todo)
assigneeIdstringnoLinear user ID to assign
prioritynumberno0 (none) to 4 (urgent)

#Example — triage agent

import { createRuntime } from '@agentskit/runtime'
import { linearTriage } from '@agentskit/tools/integrations'

const runtime = createRuntime({
  adapter,
  systemPrompt: 'You triage incoming Linear issues. List them, then assign each to the right state and team member based on the description.',
  tools: linearTriage({ apiKey: process.env.LINEAR_API_KEY! }),
})

await runtime.run('Triage all open issues for team ENG.')

#Security

  • Env var required: LINEAR_API_KEY — a Linear personal API key (Settings → API → Personal API keys).
  • The key needs at least Issues: read and Issues: write scopes.
  • Use a service account key rather than a personal key in production.
  • Linear enforces rate limits per API key; bursting large triage queues may require first pagination or a delay between calls.

Explore nearby

✎ Edit this page on GitHub·Found a problem? Open an issue →·How to contribute →

On this page

Ask the docs

Ask anything about AgentsKit. Answers come from the docs corpus via OpenRouter free-tier models. Rate limited per IP.