linear-local-dev-loop

Umożliwia szybkie uruchomienie lokalnego środowiska deweloperskiego dla integracji Linear. Zawiera szablony projektów, konfigurację zmiennych środowiskowych, tunelowanie webhooków przez ngrok oraz testy integracyjne z vitest. Przeznaczony dla deweloperów budujących narzędzia i automatyzacje na bazie Linear API. Wymaga Node.js 18+, pakietu @linear/sdk oraz oddzielnego workspace'u Linear do testów.

1. Zainstaluj skill w swoim środowisku Claude Code lub Codex. Upewnij się, że masz Node.js 18+ i dostęp do Linear API — wygeneruj klucz API w ustawieniach workspace'u Linear.

2. Utwórz nowy katalog projektu i zainicjuj go poleceniami npm: mkdir linear-integration && cd linear-integration, następnie npm init -y. Zainstaluj wymagane pakiety: npm install @linear/sdk dotenv oraz devDependencies: npm install -D typescript @types/node vitest tsx.

3. Skonfiguruj TypeScript i zmienne środowiskowe. Uruchom npx tsc --init z flagami --target ES2022 --module NodeNext --moduleResolution NodeNext --strict. Utwórz plik .env z kluczami LINEAR_API_KEY, LINEAR_WEBHOOK_SECRET i LINEAR_DEV_TEAM_KEY (nigdy nie commituj tego pliku). Dodaj .env do .gitignore.

4. Stwórz plik src/client.ts z modułem LinearClient, który importuje @linear/sdk i weryfikuje połączenie z API. Skill automatycznie wygeneruje szablon połączenia i metody do testowania.

5. Skonfiguruj tunelowanie webhooków: zainstaluj ngrok lub cloudflared, a następnie uruchom tunel (np. ngrok http 3000) aby przekierować żądania webhook'ów z Linear na lokalny port. Zaktualizuj URL webhook'a w ustawieniach Linear na adres tunelu.

6. Napisz testy integracyjne w vitest — skill dostarcza przykłady testów dla typowych operacji Linear (tworzenie issues, aktualizacja statusów, obsługa webhook'ów). Uruchom testy poleceniem npm test i iteruj nad kodem aż do uzyskania pełnej funkcjonalności.