@deploybaseline/linear

Linear GraphQL API emulator for local development and tests: GraphQL on Linear's published schema, OAuth, issues, teams, users, workflow states, comments, labels, projects, cycles, webhooks, agents, and an inspector.

Part of Baseline: local drop-in replacement services for CI and no-network sandboxes.

Usage

npx @deploybaseline/cli start --service linear

In tests:

import { createEmulator } from "@deploybaseline/cli";
import { LinearClient } from "@linear/sdk";

const linear = await createEmulator({ service: "linear" });
const client = new LinearClient({ apiKey: "lin_test_admin", apiUrl: `${linear.url}/graphql` });

const issues = await client.issues();
await linear.close();

This is not a complete Linear clone. Root fields without a resolver, and fields, filters, or inputs the emulator does not model, fail with a "not emulated" GraphQL error rather than returning made-up data.

Documentation

• Linear docs: supported queries and mutations, filters, agent sessions, OAuth, webhooks, seed config, and current limits
• API reference: http://localhost:3999/docs/linear while the CLI runs (how it works)

License

Apache-2.0