List issue agent sessions

listLinearIssueAgentSessions reads the agent-session history for one issue. Use it after delegation to monitor work without using Linear as the transport for direct Codex cloud tasks.

automations/list-linear-agent-sessions.automation.ts

import { automation, onSchedule } from "automate.ax"
import { listLinearIssueAgentSessions } from "automate.ax/linear"

export default automation("Check Linear coding sessions", () => {
  onSchedule({ schedule: "*/5 * * * *" })
  listLinearIssueAgentSessions({ issueId: "ENG-123", limit: 20 })
})

issueId accepts a UUID or human-readable identifier. Common page inputs are limit (1 to 50, default 50), after, and includeArchived. Optional second argument { account } defaults to the project binding. Returns { agentSessions: LinearAgentSession[]; pageInfo: LinearPageInfo }, ordered by most recent update. Each session includes the agent app, issue, nullable provider plan and summary, external links, lifecycle dates, and status.

⌘I

Get started

Guides

Concepts

Management API

Reference

List issue agent sessions