linear-local-dev-loop

# Linear Local Dev Loop ## Overview Set up an efficient local development workflow for building Linear integrations. Covers project scaffolding, environment config, test utilities, webhook tunneling with ngrok, and integration testing with vitest. ## Prerequisites - Node.js 18+ with TypeScript - `@linear/sdk` package - Separate Linear workspace or team for development (recommended) - ngrok or cloudflared for webhook tunnel testing ## Instructions ### Step 1: Project Scaffolding ```bash set -euo pipefail mkdir linear-integration && cd linear-integration npm init -y npm install @linear/sdk dotenv npm install -D typescript @types/node vitest tsx # TypeScript config npx tsc --init --target ES2022 --module NodeNext --moduleResolution NodeNext --strict ``` ### Step 2: Environment Configuration ```bash # .env (never commit) cat > .env << 'EOF' LINEAR_API_KEY=lin_api_dev_xxxxxxxxxxxx LINEAR_WEBHOOK_SECRET=whsec_dev_xxxxxxxxxxxx LINEAR_DEV_TEAM_KEY=DEV NODE_ENV=development EOF # .env.example (commit this for onboarding) cat > .env.example << 'EOF' LINEAR_API_KEY=lin_api_your_key_here LINEAR_WEBHOOK_SECRET= LINEAR_DEV_TEAM_KEY=DEV NODE_ENV=development EOF echo -e ".env\n.env.local\n.env.*.local" >> .gitignore ``` ### Step 3: Client Module with Connection Verification ```typescript // src/client.ts import { LinearClient } from "@linear/sdk"; import "dotenv/config"; let _client: LinearClient | null = null; export function getClient(): LinearClient { if (!_client) { const...