agentskit.js
ToolsIntegrations

linear

Linear GraphQL — search issues, create issues. For triage, sprint-planning, release-notes agents.

import { linear } from '@agentskit/tools'

const runtime = createRuntime({
  adapter,
  tools: [...linear({ token: process.env.LINEAR_API_KEY! })],
})

Sub-tools

NamePurpose
linearSearchIssuesQuery issues by team, state, labels, assignee
linearCreateIssueCreate an issue with title + description + priority

Bundled: linear(config).

Config

type LinearConfig = {
  token: string           // Personal API key or OAuth token
  teamId?: string         // Default team for creates
  fetch?: typeof fetch
}

Example — auto-intake agent

const runtime = createRuntime({
  adapter,
  systemPrompt: 'Turn user reports into Linear issues with the right team + priority.',
  tools: [...linear({ token, teamId: 'BCK' })],
})

await runtime.run('User reports: "Checkout broken on iOS 17, high priority"')

Credentials

  • Personal API key: workspace-level, full access. Good for single-user bots.
  • OAuth: user-scoped; required for multi-tenant SaaS.
✎ Edit this page on GitHub·Found a problem? Open an issue →·How to contribute →

On this page