> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Linear

> Manage Linear issues, projects, comments, attachments, and metadata from TypeScript automations.

Import Linear actions and triggers from `automate.ax/linear`. Actions accept plain values or compatible signals. Triggers watch the complete workspace represented by a statically selected account.

```ts theme={null}
import { automation } from "automate.ax"
import { createIssueComment, onLinearIssueCreated } from "automate.ax/linear"

export default automation("Welcome new Linear issues", () => {
  const event = onLinearIssueCreated()
  const issueId = event.transform(({ data }) => {
    if (typeof data.id !== "string") throw new Error("Missing Linear issue ID")
    return data.id
  })

  createIssueComment({ issueId, body: "Issue received." })
})
```

## Accounts and permissions

Leave `account` unset to use the project's default Linear OAuth binding, or pass a name or `linearAccount(...)` reference. Read actions and triggers request Linear's `read` scope; mutations request `write`. Trigger account selection must be static. See [Integration accounts](/concepts/integration-accounts).

Most issue inputs accept either a stable UUID or human-readable identifier such as `ENG-123`. Project inputs accept UUIDs or slugs where noted. List actions use Relay pagination: pass `pageInfo.endCursor` as the next request's `after` value. Page size defaults to 50 and cannot exceed 50.

## Common outputs

Linear outputs use camelCase and convert provider timestamps to `Date`. Issue output includes identifiers, team, state, assignment, project, parent, labels, priority, estimate, dates, description, source-control branch, archive/trash state, and URL. Project output includes teams, members, lead, status, priority, progress, scope, dates, content, and URL.

<CardGroup cols={2}>
  <Card title="Issues" href="/reference/integrations/linear/actions/list-issues">
    Find, create, update, archive, and relate issues.
  </Card>

  <Card title="Projects" href="/reference/integrations/linear/actions/list-projects">
    Manage project planning, status, membership, and ownership.
  </Card>

  <Card title="Comments and attachments" href="/reference/integrations/linear/actions/list-issue-comments">
    Add discussion and external resources to issues.
  </Card>

  <Card title="Workspace events" href="/reference/integrations/linear/triggers/on-issue-changed">
    Start automations from issue, comment, and project webhooks.
  </Card>
</CardGroup>