@pleaseai/emulate-linear

Linear GraphQL API emulator for local development and CI.

This package is Phase 1. It includes POST /graphql, schema introspection, PAT authentication, read only query resolvers, and Relay style pagination for issues, projects, teams, users, organizations, labels, and workflow states.

Mutations, webhooks, OAuth 2.0, and an inspector UI are follow up work.

Install

npm install @pleaseai/emulate-linear

Usually you do not install this directly — run it through the @pleaseai/emulate CLI.

Start

# Through the emulate CLI
npx @pleaseai/emulate --service linear

# From the monorepo (after `bun install && bun run build`)
bun packages/emulate/dist/index.js --service linear

A single service starts on the base port (default 4000); use -p <port> to change it.

Auth

Use the raw Linear PAT header:

curl http://localhost:4000/graphql \
  -H "Authorization: lin_api_test" \
  -H "Content-Type: application/json" \
  -d '{"query":"{ issues { nodes { id title } } }"}'

Seed Config

linear:
  api_keys: [lin_api_test]
  organizations:
    - id: org-1
      name: My Org
  teams:
    - id: team-1
      name: Engineering
      key: ENG
      organization: org-1
  workflow_states:
    - id: ws-1
      name: Todo
      type: unstarted
      team: team-1
  users:
    - id: user-1
      name: Developer
      email: [email protected]
      organization: org-1
  issues:
    - id: issue-1
      title: First issue
      team: team-1
      state: ws-1
      assignee: user-1