← ClaudeAtlas

linear-clilisted

Manage Linear issues, projects, and teams via GraphQL and curl, without installing the SDK.
Verstige/linear-cli · ★ 0 · AI & Automation · score 76
Install: claude install-skill Verstige/linear-cli
# Linear — Issue & Project Management Manage Linear issues, projects, and teams directly via the GraphQL API using `curl`. No MCP server, no OAuth flow, no extra dependencies. ## Setup 1. Get a personal API key from **Linear Settings > Account > Security & access > Personal API keys** (URL: https://linear.app/settings/account/security). Note: the org-level *Settings > API* page only shows OAuth apps and workspace-member keys, not personal keys. 2. Set `LINEAR_API_KEY` in your environment (via `hermes setup` or your env config) ## API Basics - **Endpoint:** `https://api.linear.app/graphql` (POST) - **Auth header:** `Authorization: $LINEAR_API_KEY` (no "Bearer" prefix for API keys) - **All requests are POST** with `Content-Type: application/json` - **Both UUIDs and short identifiers** (e.g., `ENG-123`) work for `issue(id:)` Base curl pattern: ```bash curl -s -X POST https://api.linear.app/graphql \ -H "Authorization: $LINEAR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "{ viewer { id name } }"}' | python3 -m json.tool ``` ## Python helper script (ergonomic alternative) For faster one-liners that don't need hand-written GraphQL, this skill ships a stdlib Python CLI at `scripts/linear_api.py`. Zero dependencies. Same auth (reads `LINEAR_API_KEY`). ```bash SCRIPT="$(dirname "$0")/linear_api.py" python3 "$SCRIPT" whoami python3 "$SCRIPT" list-teams python3 "$SCRIPT" get-issue ENG-42 python3 "$SCRIPT" get-document 0123456789ab # fetch a doc by