[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-cline-linear-sdk-scripting":3,"mdc-7cbcwf-key":39,"related-repo-cline-linear-sdk-scripting":2708,"related-org-cline-linear-sdk-scripting":2829},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":28,"repoUrl":29,"updatedAt":30,"license":31,"forks":32,"topics":33,"repo":34,"sourceUrl":37,"mdContent":38},"linear-sdk-scripting","automate Linear tasks with Node scripts","Perform actions in Linear (read, create, update, search issues, projects, comments, teams, cycles, labels, etc.) by writing and running small Node scripts against the official @linear\u002Fsdk TypeScript SDK with a personal API key. Use this when the user wants to do Linear work from the terminal without the Linear MCP server, or asks to list\u002Fopen\u002Fcreate\u002Fupdate\u002Fclose Linear issues, leave comments, or query teams, projects, users, or workflow states.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"cline","Cline","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fcline.png",[12,16,19,22,25],{"name":13,"slug":14,"type":15},"Linear","linear","tag",{"name":17,"slug":18,"type":15},"Automation","automation",{"name":20,"slug":21,"type":15},"Node.js","node-js",{"name":23,"slug":24,"type":15},"TypeScript","typescript",{"name":26,"slug":27,"type":15},"API Development","api-development",10,"https:\u002F\u002Fgithub.com\u002Fcline\u002Fskills","2026-07-12T08:13:50.82877",null,4,[],{"repoUrl":29,"stars":28,"forks":32,"topics":35,"description":36},[],"A collection of skills used at Cline","https:\u002F\u002Fgithub.com\u002Fcline\u002Fskills\u002Ftree\u002FHEAD\u002Fskills\u002Flinear-sdk-scripting","---\nname: linear-sdk-scripting\ndescription: Perform actions in Linear (read, create, update, search issues, projects, comments, teams, cycles, labels, etc.) by writing and running small Node scripts against the official @linear\u002Fsdk TypeScript SDK with a personal API key. Use this when the user wants to do Linear work from the terminal without the Linear MCP server, or asks to list\u002Fopen\u002Fcreate\u002Fupdate\u002Fclose Linear issues, leave comments, or query teams, projects, users, or workflow states.\n---\n\n# Linear SDK Scripting\n\nDrive Linear through the official TypeScript SDK (`@linear\u002Fsdk`) by writing throwaway Node scripts and executing them. This replaces the Linear MCP server: anything the MCP can do (read issues, create issues, comment, change status, query teams\u002Fprojects\u002Fcycles) you do here by calling SDK methods.\n\nThe SDK is preferred over hand-written GraphQL because pagination, relationship traversal, and mutation payloads are normalized, and method and input names are predictable. When you need a field or filter you do not know, consult the docs index in `references\u002Fdocs-index.md` and fetch the specific page rather than guessing.\n\n## Workflow at a glance\n\nBe reactive: try the script first, recover on auth failure, and only create a key as a last resort. Do not gate on `$LINEAR_API_KEY` being set in the current shell, that variable is almost always empty here even when a valid key is already persisted (see Setup).\n\n1. Make sure the SDK is installed in the working dir. See Setup.\n2. Write a small `.mjs` script into the working dir that imports `LinearClient` and does the task.\n3. Run it with `node`, sourcing the shell profiles first so a persisted key is picked up (see Execution pattern).\n4. If it fails with a 401 \u002F `AuthenticationLinearError`, source the shell profiles and retry once. Only if it still fails is the key actually missing or invalid: run the API key setup flow with the user.\n\n## Setup\n\n### 1. Personal API key\n\nThe SDK authenticates with a Linear personal API key read from the `LINEAR_API_KEY` environment variable.\n\nDo not decide whether a key exists by checking the env var up front. Scripts here run in a non-interactive, non-login shell that does not source `~\u002F.zshrc`, `~\u002F.zshenv`, `~\u002F.bashrc`, etc., so `$LINEAR_API_KEY` reads as empty even when a valid key is already persisted in one of those files. An empty variable in this shell does not mean the key is unconfigured.\n\nInstead, let the script attempt the work (the Execution pattern sources the profiles first), and only treat the key as missing if it still auth-fails after that. See Handling auth failures.\n\nOnly when the key is genuinely missing, guide the user through creating one:\n\n1. Open Security and access settings: https:\u002F\u002Flinear.app\u002Fsettings\u002Faccount\u002Fsecurity\n2. Under Personal API keys, create a new key. Copy it (it starts with `lin_api_`).\n3. Ask the user to paste their key, then load it into the current session so you can use it immediately without a new terminal:\n\n   ```sh\n   export LINEAR_API_KEY=\"lin_api_REPLACE_ME\"\n   ```\n\n4. Ask before persisting. The key is a secret and persisting it writes to a file the user owns, so do not do it on your own initiative. Explicitly ask first, for example: \"Do you want me to persist this key to your shell profile (`~\u002F.zshrc`) so it's available in future sessions?\" Wait for a clear yes.\n\n   Only after the user confirms, perform the write yourself using the command for the user's shell:\n\n   - zsh:\n     ```sh\n     echo 'export LINEAR_API_KEY=\"lin_api_REPLACE_ME\"' >> ~\u002F.zshrc\n     ```\n   - bash (or `~\u002F.bash_profile` on macOS login shells):\n     ```sh\n     echo 'export LINEAR_API_KEY=\"lin_api_REPLACE_ME\"' >> ~\u002F.bashrc\n     ```\n   - fish:\n     ```sh\n     echo 'set -gx LINEAR_API_KEY \"lin_api_REPLACE_ME\"' >> ~\u002F.config\u002Ffish\u002Fconfig.fish\n     ```\n\n   This explicit in-conversation approval is what makes the write a user-requested action rather than an agent-initiated one. If the user declines or does not answer, do not persist the key; it will simply need to be re-set next session.\n\nNever print the key value back to the transcript or commit it anywhere. Treat it as a secret.\n\n### 2. Install the SDK in a working directory\n\nKeep a dedicated working directory with its own `node_modules`. Running scripts from inside it lets you use plain `import` with top-level await and no `NODE_PATH` tricks. Requires Node 18 or newer.\n\n```sh\nLINEAR_DIR=\"${XDG_CACHE_HOME:-$HOME\u002F.cache}\u002Flinear-sdk-scripting\"\nmkdir -p \"$LINEAR_DIR\"\ncd \"$LINEAR_DIR\"\n[ -f package.json ] || npm init -y >\u002Fdev\u002Fnull\nnpm ls @linear\u002Fsdk >\u002Fdev\u002Fnull 2>&1 || npm install @linear\u002Fsdk\n```\n\nThis is a one-time setup; reuse the directory afterwards.\n\n## Execution pattern (canonical)\n\nFor each task, write a script into the working directory and run it. Use the env var; do not inline the key.\n\nSource the common shell profiles before invoking `node` so a persisted key is pulled into the environment (this shell does not source them automatically). This preamble is harmless when no key is persisted, so use it as the standard way to run every script:\n\n```sh\nLINEAR_DIR=\"${XDG_CACHE_HOME:-$HOME\u002F.cache}\u002Flinear-sdk-scripting\"\ncat > \"$LINEAR_DIR\u002Ftask.mjs\" \u003C\u003C'EOF'\nimport { LinearClient } from \"@linear\u002Fsdk\"\n\nconst linear = new LinearClient({ apiKey: process.env.LINEAR_API_KEY })\n\nconst me = await linear.viewer\nconst myIssues = await me.assignedIssues({ first: 20 })\nfor (const issue of myIssues.nodes) {\n  console.log(`${issue.identifier}  ${issue.title}`)\n}\nEOF\nfor f in ~\u002F.zshenv ~\u002F.zshrc ~\u002F.zprofile ~\u002F.profile ~\u002F.bashrc ~\u002F.bash_profile; do\n  [ -f \"$f\" ] && source \"$f\"\ndone\nnode \"$LINEAR_DIR\u002Ftask.mjs\"\n```\n\nNotes:\n- The script file lives in the working dir, so `import \"@linear\u002Fsdk\"` resolves against that dir's `node_modules`.\n- `.mjs` gives you top-level `await`, so no async wrapper is needed.\n- Emit machine-readable output (`console.log(JSON.stringify(...))`) when you need to parse results in a later step.\n\n## Handling auth failures\n\nA missing or invalid key surfaces as an `AuthenticationLinearError` with `status` 401. Detect it and route to the key setup flow:\n\n```js\ntry {\n  const me = await linear.viewer\n  console.log(me.displayName)\n} catch (e) {\n  if (e?.status === 401 || e?.constructor?.name === \"AuthenticationLinearError\") {\n    console.error(\"AUTH_FAILED: set up LINEAR_API_KEY\")\n    process.exit(2)\n  }\n  throw e\n}\n```\n\nIf you see `AUTH_FAILED` (or the script crashes before any data), recover in this order rather than jumping straight to creating a key:\n\n1. Source the shell profiles and retry once. The key may already be persisted in a profile file that this shell never sourced. Pull it in and re-run the same script:\n\n   ```sh\n   for f in ~\u002F.zshenv ~\u002F.zshrc ~\u002F.zprofile ~\u002F.profile ~\u002F.bashrc ~\u002F.bash_profile; do\n     [ -f \"$f\" ] && source \"$f\"\n   done\n   node \"$LINEAR_DIR\u002Ftask.mjs\"\n   ```\n\n   (If you already ran with the canonical Execution pattern preamble, the profiles were sourced, so this retry will only help if you ran without it.)\n\n2. Only if it still auth-fails, the key is genuinely missing or invalid. Now do the Personal API key setup with the user (create and persist a new key), then rerun.\n\n## Common operations\n\nConcise recipes are inline below. Fuller examples (filtering, pagination loops, closing issues via workflow states, batch operations) are in `references\u002Frecipes.md`. The doc index is in `references\u002Fdocs-index.md`.\n\nRead:\n\n```js\n\u002F\u002F Current user\nconst me = await linear.viewer\n\n\u002F\u002F List issues (newest first), with a filter\nconst issues = await linear.issues({\n  first: 25,\n  filter: { state: { type: { eq: \"started\" } } },\n})\n\n\u002F\u002F A single issue by UUID\nconst issue = await linear.issue(\"UUID\")\n\n\u002F\u002F Teams, users, projects\nconst teams = await linear.teams()\nconst users = await linear.users()\nconst projects = await linear.projects({ first: 50 })\n```\n\nWrite (mutations return a payload with `success` and the entity, often as a promise):\n\n```js\n\u002F\u002F Create\nconst created = await linear.createIssue({\n  teamId: \"TEAM_UUID\",\n  title: \"Title\",\n  description: \"Markdown body\",\n})\nconst newIssue = await created.issue\n\n\u002F\u002F Update (e.g. retitle, reassign)\nawait linear.updateIssue(\"ISSUE_UUID\", { title: \"New title\", assigneeId: \"USER_UUID\" })\n\n\u002F\u002F Comment\nawait linear.createComment({ issueId: \"ISSUE_UUID\", body: \"Comment text\" })\n```\n\nTo resolve human inputs to IDs (team key like `ENG`, a workflow state name like `Done`, an assignee email), look them up first. See `references\u002Frecipes.md` for the lookup-then-mutate patterns, including how to close an issue by finding the team's completed workflow state.\n\n## When you need something not covered here\n\nThe Linear schema is large. Instead of guessing field or filter names:\n\n1. Open `references\u002Fdocs-index.md` and pick the relevant page.\n2. Fetch that page (filtering, pagination, SDK fetching and modifying data, or the GraphQL schema reference) and use the exact names from it.\n\n## Gotchas\n\n- Run scripts from the working dir (or point at a script inside it) so `@linear\u002Fsdk` resolves. `NODE_PATH` does not resolve packages for ESM `import`; it only works for CommonJS `require`.\n- Many SDK properties and nested relations are async and return promises or connections. Await them (`await issue.state`, `await issue.assignee`).\n- Connections paginate. Use `connection.pageInfo.hasNextPage` and `await connection.fetchNext()`, or iterate. See `references\u002Frecipes.md`.\n- Mutation results expose `success` and the mutated entity; the entity accessor is usually a promise (`await payload.issue`).\n",{"data":40,"body":41},{"name":4,"description":6},{"type":42,"children":43},"root",[44,52,67,80,87,100,157,163,170,183,218,223,228,475,480,486,515,737,742,748,753,765,1094,1099,1152,1158,1178,1487,1500,1649,1655,1674,1679,2120,2133,2536,2564,2570,2575,2595,2601,2702],{"type":45,"tag":46,"props":47,"children":48},"element","h1",{"id":4},[49],{"type":50,"value":51},"text","Linear SDK Scripting",{"type":45,"tag":53,"props":54,"children":55},"p",{},[56,58,65],{"type":50,"value":57},"Drive Linear through the official TypeScript SDK (",{"type":45,"tag":59,"props":60,"children":62},"code",{"className":61},[],[63],{"type":50,"value":64},"@linear\u002Fsdk",{"type":50,"value":66},") by writing throwaway Node scripts and executing them. This replaces the Linear MCP server: anything the MCP can do (read issues, create issues, comment, change status, query teams\u002Fprojects\u002Fcycles) you do here by calling SDK methods.",{"type":45,"tag":53,"props":68,"children":69},{},[70,72,78],{"type":50,"value":71},"The SDK is preferred over hand-written GraphQL because pagination, relationship traversal, and mutation payloads are normalized, and method and input names are predictable. When you need a field or filter you do not know, consult the docs index in ",{"type":45,"tag":59,"props":73,"children":75},{"className":74},[],[76],{"type":50,"value":77},"references\u002Fdocs-index.md",{"type":50,"value":79}," and fetch the specific page rather than guessing.",{"type":45,"tag":81,"props":82,"children":84},"h2",{"id":83},"workflow-at-a-glance",[85],{"type":50,"value":86},"Workflow at a glance",{"type":45,"tag":53,"props":88,"children":89},{},[90,92,98],{"type":50,"value":91},"Be reactive: try the script first, recover on auth failure, and only create a key as a last resort. Do not gate on ",{"type":45,"tag":59,"props":93,"children":95},{"className":94},[],[96],{"type":50,"value":97},"$LINEAR_API_KEY",{"type":50,"value":99}," being set in the current shell, that variable is almost always empty here even when a valid key is already persisted (see Setup).",{"type":45,"tag":101,"props":102,"children":103},"ol",{},[104,110,131,144],{"type":45,"tag":105,"props":106,"children":107},"li",{},[108],{"type":50,"value":109},"Make sure the SDK is installed in the working dir. See Setup.",{"type":45,"tag":105,"props":111,"children":112},{},[113,115,121,123,129],{"type":50,"value":114},"Write a small ",{"type":45,"tag":59,"props":116,"children":118},{"className":117},[],[119],{"type":50,"value":120},".mjs",{"type":50,"value":122}," script into the working dir that imports ",{"type":45,"tag":59,"props":124,"children":126},{"className":125},[],[127],{"type":50,"value":128},"LinearClient",{"type":50,"value":130}," and does the task.",{"type":45,"tag":105,"props":132,"children":133},{},[134,136,142],{"type":50,"value":135},"Run it with ",{"type":45,"tag":59,"props":137,"children":139},{"className":138},[],[140],{"type":50,"value":141},"node",{"type":50,"value":143},", sourcing the shell profiles first so a persisted key is picked up (see Execution pattern).",{"type":45,"tag":105,"props":145,"children":146},{},[147,149,155],{"type":50,"value":148},"If it fails with a 401 \u002F ",{"type":45,"tag":59,"props":150,"children":152},{"className":151},[],[153],{"type":50,"value":154},"AuthenticationLinearError",{"type":50,"value":156},", source the shell profiles and retry once. Only if it still fails is the key actually missing or invalid: run the API key setup flow with the user.",{"type":45,"tag":81,"props":158,"children":160},{"id":159},"setup",[161],{"type":50,"value":162},"Setup",{"type":45,"tag":164,"props":165,"children":167},"h3",{"id":166},"_1-personal-api-key",[168],{"type":50,"value":169},"1. Personal API key",{"type":45,"tag":53,"props":171,"children":172},{},[173,175,181],{"type":50,"value":174},"The SDK authenticates with a Linear personal API key read from the ",{"type":45,"tag":59,"props":176,"children":178},{"className":177},[],[179],{"type":50,"value":180},"LINEAR_API_KEY",{"type":50,"value":182}," environment variable.",{"type":45,"tag":53,"props":184,"children":185},{},[186,188,194,196,202,203,209,211,216],{"type":50,"value":187},"Do not decide whether a key exists by checking the env var up front. Scripts here run in a non-interactive, non-login shell that does not source ",{"type":45,"tag":59,"props":189,"children":191},{"className":190},[],[192],{"type":50,"value":193},"~\u002F.zshrc",{"type":50,"value":195},", ",{"type":45,"tag":59,"props":197,"children":199},{"className":198},[],[200],{"type":50,"value":201},"~\u002F.zshenv",{"type":50,"value":195},{"type":45,"tag":59,"props":204,"children":206},{"className":205},[],[207],{"type":50,"value":208},"~\u002F.bashrc",{"type":50,"value":210},", etc., so ",{"type":45,"tag":59,"props":212,"children":214},{"className":213},[],[215],{"type":50,"value":97},{"type":50,"value":217}," reads as empty even when a valid key is already persisted in one of those files. An empty variable in this shell does not mean the key is unconfigured.",{"type":45,"tag":53,"props":219,"children":220},{},[221],{"type":50,"value":222},"Instead, let the script attempt the work (the Execution pattern sources the profiles first), and only treat the key as missing if it still auth-fails after that. See Handling auth failures.",{"type":45,"tag":53,"props":224,"children":225},{},[226],{"type":50,"value":227},"Only when the key is genuinely missing, guide the user through creating one:",{"type":45,"tag":101,"props":229,"children":230},{},[231,244,257,313],{"type":45,"tag":105,"props":232,"children":233},{},[234,236],{"type":50,"value":235},"Open Security and access settings: ",{"type":45,"tag":237,"props":238,"children":242},"a",{"href":239,"rel":240},"https:\u002F\u002Flinear.app\u002Fsettings\u002Faccount\u002Fsecurity",[241],"nofollow",[243],{"type":50,"value":239},{"type":45,"tag":105,"props":245,"children":246},{},[247,249,255],{"type":50,"value":248},"Under Personal API keys, create a new key. Copy it (it starts with ",{"type":45,"tag":59,"props":250,"children":252},{"className":251},[],[253],{"type":50,"value":254},"lin_api_",{"type":50,"value":256},").",{"type":45,"tag":105,"props":258,"children":259},{},[260,262],{"type":50,"value":261},"Ask the user to paste their key, then load it into the current session so you can use it immediately without a new terminal:",{"type":45,"tag":263,"props":264,"children":269},"pre",{"className":265,"code":266,"language":267,"meta":268,"style":268},"language-sh shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","export LINEAR_API_KEY=\"lin_api_REPLACE_ME\"\n","sh","",[270],{"type":45,"tag":59,"props":271,"children":272},{"__ignoreMap":268},[273],{"type":45,"tag":274,"props":275,"children":278},"span",{"class":276,"line":277},"line",1,[279,285,291,297,302,308],{"type":45,"tag":274,"props":280,"children":282},{"style":281},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[283],{"type":50,"value":284},"export",{"type":45,"tag":274,"props":286,"children":288},{"style":287},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[289],{"type":50,"value":290}," LINEAR_API_KEY",{"type":45,"tag":274,"props":292,"children":294},{"style":293},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[295],{"type":50,"value":296},"=",{"type":45,"tag":274,"props":298,"children":299},{"style":293},[300],{"type":50,"value":301},"\"",{"type":45,"tag":274,"props":303,"children":305},{"style":304},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[306],{"type":50,"value":307},"lin_api_REPLACE_ME",{"type":45,"tag":274,"props":309,"children":310},{"style":293},[311],{"type":50,"value":312},"\"\n",{"type":45,"tag":105,"props":314,"children":315},{},[316,318,323,325,329,331,470,473],{"type":50,"value":317},"Ask before persisting. The key is a secret and persisting it writes to a file the user owns, so do not do it on your own initiative. Explicitly ask first, for example: \"Do you want me to persist this key to your shell profile (",{"type":45,"tag":59,"props":319,"children":321},{"className":320},[],[322],{"type":50,"value":193},{"type":50,"value":324},") so it's available in future sessions?\" Wait for a clear yes.",{"type":45,"tag":326,"props":327,"children":328},"br",{},[],{"type":50,"value":330},"Only after the user confirms, perform the write yourself using the command for the user's shell:",{"type":45,"tag":332,"props":333,"children":334},"ul",{},[335,381,429],{"type":45,"tag":105,"props":336,"children":337},{},[338,340],{"type":50,"value":339},"zsh:\n",{"type":45,"tag":263,"props":341,"children":343},{"className":265,"code":342,"language":267,"meta":268,"style":268},"echo 'export LINEAR_API_KEY=\"lin_api_REPLACE_ME\"' >> ~\u002F.zshrc\n",[344],{"type":45,"tag":59,"props":345,"children":346},{"__ignoreMap":268},[347],{"type":45,"tag":274,"props":348,"children":349},{"class":276,"line":277},[350,356,361,366,371,376],{"type":45,"tag":274,"props":351,"children":353},{"style":352},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[354],{"type":50,"value":355},"echo",{"type":45,"tag":274,"props":357,"children":358},{"style":293},[359],{"type":50,"value":360}," '",{"type":45,"tag":274,"props":362,"children":363},{"style":304},[364],{"type":50,"value":365},"export LINEAR_API_KEY=\"lin_api_REPLACE_ME\"",{"type":45,"tag":274,"props":367,"children":368},{"style":293},[369],{"type":50,"value":370},"'",{"type":45,"tag":274,"props":372,"children":373},{"style":293},[374],{"type":50,"value":375}," >>",{"type":45,"tag":274,"props":377,"children":378},{"style":304},[379],{"type":50,"value":380}," ~\u002F.zshrc\n",{"type":45,"tag":105,"props":382,"children":383},{},[384,386,392,394],{"type":50,"value":385},"bash (or ",{"type":45,"tag":59,"props":387,"children":389},{"className":388},[],[390],{"type":50,"value":391},"~\u002F.bash_profile",{"type":50,"value":393}," on macOS login shells):\n",{"type":45,"tag":263,"props":395,"children":397},{"className":265,"code":396,"language":267,"meta":268,"style":268},"echo 'export LINEAR_API_KEY=\"lin_api_REPLACE_ME\"' >> ~\u002F.bashrc\n",[398],{"type":45,"tag":59,"props":399,"children":400},{"__ignoreMap":268},[401],{"type":45,"tag":274,"props":402,"children":403},{"class":276,"line":277},[404,408,412,416,420,424],{"type":45,"tag":274,"props":405,"children":406},{"style":352},[407],{"type":50,"value":355},{"type":45,"tag":274,"props":409,"children":410},{"style":293},[411],{"type":50,"value":360},{"type":45,"tag":274,"props":413,"children":414},{"style":304},[415],{"type":50,"value":365},{"type":45,"tag":274,"props":417,"children":418},{"style":293},[419],{"type":50,"value":370},{"type":45,"tag":274,"props":421,"children":422},{"style":293},[423],{"type":50,"value":375},{"type":45,"tag":274,"props":425,"children":426},{"style":304},[427],{"type":50,"value":428}," ~\u002F.bashrc\n",{"type":45,"tag":105,"props":430,"children":431},{},[432,434],{"type":50,"value":433},"fish:\n",{"type":45,"tag":263,"props":435,"children":437},{"className":265,"code":436,"language":267,"meta":268,"style":268},"echo 'set -gx LINEAR_API_KEY \"lin_api_REPLACE_ME\"' >> ~\u002F.config\u002Ffish\u002Fconfig.fish\n",[438],{"type":45,"tag":59,"props":439,"children":440},{"__ignoreMap":268},[441],{"type":45,"tag":274,"props":442,"children":443},{"class":276,"line":277},[444,448,452,457,461,465],{"type":45,"tag":274,"props":445,"children":446},{"style":352},[447],{"type":50,"value":355},{"type":45,"tag":274,"props":449,"children":450},{"style":293},[451],{"type":50,"value":360},{"type":45,"tag":274,"props":453,"children":454},{"style":304},[455],{"type":50,"value":456},"set -gx LINEAR_API_KEY \"lin_api_REPLACE_ME\"",{"type":45,"tag":274,"props":458,"children":459},{"style":293},[460],{"type":50,"value":370},{"type":45,"tag":274,"props":462,"children":463},{"style":293},[464],{"type":50,"value":375},{"type":45,"tag":274,"props":466,"children":467},{"style":304},[468],{"type":50,"value":469}," ~\u002F.config\u002Ffish\u002Fconfig.fish\n",{"type":45,"tag":326,"props":471,"children":472},{},[],{"type":50,"value":474},"This explicit in-conversation approval is what makes the write a user-requested action rather than an agent-initiated one. If the user declines or does not answer, do not persist the key; it will simply need to be re-set next session.",{"type":45,"tag":53,"props":476,"children":477},{},[478],{"type":50,"value":479},"Never print the key value back to the transcript or commit it anywhere. Treat it as a secret.",{"type":45,"tag":164,"props":481,"children":483},{"id":482},"_2-install-the-sdk-in-a-working-directory",[484],{"type":50,"value":485},"2. Install the SDK in a working directory",{"type":45,"tag":53,"props":487,"children":488},{},[489,491,497,499,505,507,513],{"type":50,"value":490},"Keep a dedicated working directory with its own ",{"type":45,"tag":59,"props":492,"children":494},{"className":493},[],[495],{"type":50,"value":496},"node_modules",{"type":50,"value":498},". Running scripts from inside it lets you use plain ",{"type":45,"tag":59,"props":500,"children":502},{"className":501},[],[503],{"type":50,"value":504},"import",{"type":50,"value":506}," with top-level await and no ",{"type":45,"tag":59,"props":508,"children":510},{"className":509},[],[511],{"type":50,"value":512},"NODE_PATH",{"type":50,"value":514}," tricks. Requires Node 18 or newer.",{"type":45,"tag":263,"props":516,"children":518},{"className":265,"code":517,"language":267,"meta":268,"style":268},"LINEAR_DIR=\"${XDG_CACHE_HOME:-$HOME\u002F.cache}\u002Flinear-sdk-scripting\"\nmkdir -p \"$LINEAR_DIR\"\ncd \"$LINEAR_DIR\"\n[ -f package.json ] || npm init -y >\u002Fdev\u002Fnull\nnpm ls @linear\u002Fsdk >\u002Fdev\u002Fnull 2>&1 || npm install @linear\u002Fsdk\n",[519],{"type":45,"tag":59,"props":520,"children":521},{"__ignoreMap":268},[522,583,612,633,686],{"type":45,"tag":274,"props":523,"children":524},{"class":276,"line":277},[525,530,534,539,544,549,554,559,564,569,574,579],{"type":45,"tag":274,"props":526,"children":527},{"style":287},[528],{"type":50,"value":529},"LINEAR_DIR",{"type":45,"tag":274,"props":531,"children":532},{"style":293},[533],{"type":50,"value":296},{"type":45,"tag":274,"props":535,"children":536},{"style":293},[537],{"type":50,"value":538},"\"${",{"type":45,"tag":274,"props":540,"children":541},{"style":287},[542],{"type":50,"value":543},"XDG_CACHE_HOME",{"type":45,"tag":274,"props":545,"children":546},{"style":293},[547],{"type":50,"value":548},":-",{"type":45,"tag":274,"props":550,"children":551},{"style":287},[552],{"type":50,"value":553},"$HOME",{"type":45,"tag":274,"props":555,"children":556},{"style":293},[557],{"type":50,"value":558},"\u002F",{"type":45,"tag":274,"props":560,"children":561},{"style":304},[562],{"type":50,"value":563},".",{"type":45,"tag":274,"props":565,"children":566},{"style":287},[567],{"type":50,"value":568},"cache",{"type":45,"tag":274,"props":570,"children":571},{"style":293},[572],{"type":50,"value":573},"}",{"type":45,"tag":274,"props":575,"children":576},{"style":304},[577],{"type":50,"value":578},"\u002Flinear-sdk-scripting",{"type":45,"tag":274,"props":580,"children":581},{"style":293},[582],{"type":50,"value":312},{"type":45,"tag":274,"props":584,"children":586},{"class":276,"line":585},2,[587,593,598,603,608],{"type":45,"tag":274,"props":588,"children":590},{"style":589},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[591],{"type":50,"value":592},"mkdir",{"type":45,"tag":274,"props":594,"children":595},{"style":304},[596],{"type":50,"value":597}," -p",{"type":45,"tag":274,"props":599,"children":600},{"style":293},[601],{"type":50,"value":602}," \"",{"type":45,"tag":274,"props":604,"children":605},{"style":287},[606],{"type":50,"value":607},"$LINEAR_DIR",{"type":45,"tag":274,"props":609,"children":610},{"style":293},[611],{"type":50,"value":312},{"type":45,"tag":274,"props":613,"children":615},{"class":276,"line":614},3,[616,621,625,629],{"type":45,"tag":274,"props":617,"children":618},{"style":352},[619],{"type":50,"value":620},"cd",{"type":45,"tag":274,"props":622,"children":623},{"style":293},[624],{"type":50,"value":602},{"type":45,"tag":274,"props":626,"children":627},{"style":287},[628],{"type":50,"value":607},{"type":45,"tag":274,"props":630,"children":631},{"style":293},[632],{"type":50,"value":312},{"type":45,"tag":274,"props":634,"children":635},{"class":276,"line":32},[636,641,646,651,656,661,666,671,676,681],{"type":45,"tag":274,"props":637,"children":638},{"style":293},[639],{"type":50,"value":640},"[",{"type":45,"tag":274,"props":642,"children":643},{"style":293},[644],{"type":50,"value":645}," -f",{"type":45,"tag":274,"props":647,"children":648},{"style":287},[649],{"type":50,"value":650}," package.json ",{"type":45,"tag":274,"props":652,"children":653},{"style":293},[654],{"type":50,"value":655},"]",{"type":45,"tag":274,"props":657,"children":658},{"style":293},[659],{"type":50,"value":660}," ||",{"type":45,"tag":274,"props":662,"children":663},{"style":589},[664],{"type":50,"value":665}," npm",{"type":45,"tag":274,"props":667,"children":668},{"style":304},[669],{"type":50,"value":670}," init",{"type":45,"tag":274,"props":672,"children":673},{"style":304},[674],{"type":50,"value":675}," -y",{"type":45,"tag":274,"props":677,"children":678},{"style":293},[679],{"type":50,"value":680}," >",{"type":45,"tag":274,"props":682,"children":683},{"style":304},[684],{"type":50,"value":685},"\u002Fdev\u002Fnull\n",{"type":45,"tag":274,"props":687,"children":689},{"class":276,"line":688},5,[690,695,700,705,709,714,719,723,727,732],{"type":45,"tag":274,"props":691,"children":692},{"style":589},[693],{"type":50,"value":694},"npm",{"type":45,"tag":274,"props":696,"children":697},{"style":304},[698],{"type":50,"value":699}," ls",{"type":45,"tag":274,"props":701,"children":702},{"style":304},[703],{"type":50,"value":704}," @linear\u002Fsdk",{"type":45,"tag":274,"props":706,"children":707},{"style":293},[708],{"type":50,"value":680},{"type":45,"tag":274,"props":710,"children":711},{"style":304},[712],{"type":50,"value":713},"\u002Fdev\u002Fnull",{"type":45,"tag":274,"props":715,"children":716},{"style":293},[717],{"type":50,"value":718}," 2>&1",{"type":45,"tag":274,"props":720,"children":721},{"style":293},[722],{"type":50,"value":660},{"type":45,"tag":274,"props":724,"children":725},{"style":589},[726],{"type":50,"value":665},{"type":45,"tag":274,"props":728,"children":729},{"style":304},[730],{"type":50,"value":731}," install",{"type":45,"tag":274,"props":733,"children":734},{"style":304},[735],{"type":50,"value":736}," @linear\u002Fsdk\n",{"type":45,"tag":53,"props":738,"children":739},{},[740],{"type":50,"value":741},"This is a one-time setup; reuse the directory afterwards.",{"type":45,"tag":81,"props":743,"children":745},{"id":744},"execution-pattern-canonical",[746],{"type":50,"value":747},"Execution pattern (canonical)",{"type":45,"tag":53,"props":749,"children":750},{},[751],{"type":50,"value":752},"For each task, write a script into the working directory and run it. Use the env var; do not inline the key.",{"type":45,"tag":53,"props":754,"children":755},{},[756,758,763],{"type":50,"value":757},"Source the common shell profiles before invoking ",{"type":45,"tag":59,"props":759,"children":761},{"className":760},[],[762],{"type":50,"value":141},{"type":50,"value":764}," so a persisted key is pulled into the environment (this shell does not source them automatically). This preamble is harmless when no key is persisted, so use it as the standard way to run every script:",{"type":45,"tag":263,"props":766,"children":768},{"className":265,"code":767,"language":267,"meta":268,"style":268},"LINEAR_DIR=\"${XDG_CACHE_HOME:-$HOME\u002F.cache}\u002Flinear-sdk-scripting\"\ncat > \"$LINEAR_DIR\u002Ftask.mjs\" \u003C\u003C'EOF'\nimport { LinearClient } from \"@linear\u002Fsdk\"\n\nconst linear = new LinearClient({ apiKey: process.env.LINEAR_API_KEY })\n\nconst me = await linear.viewer\nconst myIssues = await me.assignedIssues({ first: 20 })\nfor (const issue of myIssues.nodes) {\n  console.log(`${issue.identifier}  ${issue.title}`)\n}\nEOF\nfor f in ~\u002F.zshenv ~\u002F.zshrc ~\u002F.zprofile ~\u002F.profile ~\u002F.bashrc ~\u002F.bash_profile; do\n  [ -f \"$f\" ] && source \"$f\"\ndone\nnode \"$LINEAR_DIR\u002Ftask.mjs\"\n",[769],{"type":45,"tag":59,"props":770,"children":771},{"__ignoreMap":268},[772,823,862,870,879,887,895,904,913,922,930,939,948,1008,1061,1070],{"type":45,"tag":274,"props":773,"children":774},{"class":276,"line":277},[775,779,783,787,791,795,799,803,807,811,815,819],{"type":45,"tag":274,"props":776,"children":777},{"style":287},[778],{"type":50,"value":529},{"type":45,"tag":274,"props":780,"children":781},{"style":293},[782],{"type":50,"value":296},{"type":45,"tag":274,"props":784,"children":785},{"style":293},[786],{"type":50,"value":538},{"type":45,"tag":274,"props":788,"children":789},{"style":287},[790],{"type":50,"value":543},{"type":45,"tag":274,"props":792,"children":793},{"style":293},[794],{"type":50,"value":548},{"type":45,"tag":274,"props":796,"children":797},{"style":287},[798],{"type":50,"value":553},{"type":45,"tag":274,"props":800,"children":801},{"style":293},[802],{"type":50,"value":558},{"type":45,"tag":274,"props":804,"children":805},{"style":304},[806],{"type":50,"value":563},{"type":45,"tag":274,"props":808,"children":809},{"style":287},[810],{"type":50,"value":568},{"type":45,"tag":274,"props":812,"children":813},{"style":293},[814],{"type":50,"value":573},{"type":45,"tag":274,"props":816,"children":817},{"style":304},[818],{"type":50,"value":578},{"type":45,"tag":274,"props":820,"children":821},{"style":293},[822],{"type":50,"value":312},{"type":45,"tag":274,"props":824,"children":825},{"class":276,"line":585},[826,831,835,839,843,848,852,857],{"type":45,"tag":274,"props":827,"children":828},{"style":589},[829],{"type":50,"value":830},"cat",{"type":45,"tag":274,"props":832,"children":833},{"style":293},[834],{"type":50,"value":680},{"type":45,"tag":274,"props":836,"children":837},{"style":293},[838],{"type":50,"value":602},{"type":45,"tag":274,"props":840,"children":841},{"style":287},[842],{"type":50,"value":607},{"type":45,"tag":274,"props":844,"children":845},{"style":304},[846],{"type":50,"value":847},"\u002Ftask.mjs",{"type":45,"tag":274,"props":849,"children":850},{"style":293},[851],{"type":50,"value":301},{"type":45,"tag":274,"props":853,"children":854},{"style":293},[855],{"type":50,"value":856}," \u003C\u003C",{"type":45,"tag":274,"props":858,"children":859},{"style":293},[860],{"type":50,"value":861},"'EOF'\n",{"type":45,"tag":274,"props":863,"children":864},{"class":276,"line":614},[865],{"type":45,"tag":274,"props":866,"children":867},{"style":304},[868],{"type":50,"value":869},"import { LinearClient } from \"@linear\u002Fsdk\"\n",{"type":45,"tag":274,"props":871,"children":872},{"class":276,"line":32},[873],{"type":45,"tag":274,"props":874,"children":876},{"emptyLinePlaceholder":875},true,[877],{"type":50,"value":878},"\n",{"type":45,"tag":274,"props":880,"children":881},{"class":276,"line":688},[882],{"type":45,"tag":274,"props":883,"children":884},{"style":304},[885],{"type":50,"value":886},"const linear = new LinearClient({ apiKey: process.env.LINEAR_API_KEY })\n",{"type":45,"tag":274,"props":888,"children":890},{"class":276,"line":889},6,[891],{"type":45,"tag":274,"props":892,"children":893},{"emptyLinePlaceholder":875},[894],{"type":50,"value":878},{"type":45,"tag":274,"props":896,"children":898},{"class":276,"line":897},7,[899],{"type":45,"tag":274,"props":900,"children":901},{"style":304},[902],{"type":50,"value":903},"const me = await linear.viewer\n",{"type":45,"tag":274,"props":905,"children":907},{"class":276,"line":906},8,[908],{"type":45,"tag":274,"props":909,"children":910},{"style":304},[911],{"type":50,"value":912},"const myIssues = await me.assignedIssues({ first: 20 })\n",{"type":45,"tag":274,"props":914,"children":916},{"class":276,"line":915},9,[917],{"type":45,"tag":274,"props":918,"children":919},{"style":304},[920],{"type":50,"value":921},"for (const issue of myIssues.nodes) {\n",{"type":45,"tag":274,"props":923,"children":924},{"class":276,"line":28},[925],{"type":45,"tag":274,"props":926,"children":927},{"style":304},[928],{"type":50,"value":929},"  console.log(`${issue.identifier}  ${issue.title}`)\n",{"type":45,"tag":274,"props":931,"children":933},{"class":276,"line":932},11,[934],{"type":45,"tag":274,"props":935,"children":936},{"style":304},[937],{"type":50,"value":938},"}\n",{"type":45,"tag":274,"props":940,"children":942},{"class":276,"line":941},12,[943],{"type":45,"tag":274,"props":944,"children":945},{"style":293},[946],{"type":50,"value":947},"EOF\n",{"type":45,"tag":274,"props":949,"children":951},{"class":276,"line":950},13,[952,958,963,968,973,978,983,988,993,998,1003],{"type":45,"tag":274,"props":953,"children":955},{"style":954},"--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic",[956],{"type":50,"value":957},"for",{"type":45,"tag":274,"props":959,"children":960},{"style":287},[961],{"type":50,"value":962}," f ",{"type":45,"tag":274,"props":964,"children":965},{"style":954},[966],{"type":50,"value":967},"in",{"type":45,"tag":274,"props":969,"children":970},{"style":304},[971],{"type":50,"value":972}," ~\u002F.zshenv",{"type":45,"tag":274,"props":974,"children":975},{"style":304},[976],{"type":50,"value":977}," ~\u002F.zshrc",{"type":45,"tag":274,"props":979,"children":980},{"style":304},[981],{"type":50,"value":982}," ~\u002F.zprofile",{"type":45,"tag":274,"props":984,"children":985},{"style":304},[986],{"type":50,"value":987}," ~\u002F.profile",{"type":45,"tag":274,"props":989,"children":990},{"style":304},[991],{"type":50,"value":992}," ~\u002F.bashrc",{"type":45,"tag":274,"props":994,"children":995},{"style":304},[996],{"type":50,"value":997}," ~\u002F.bash_profile",{"type":45,"tag":274,"props":999,"children":1000},{"style":293},[1001],{"type":50,"value":1002},";",{"type":45,"tag":274,"props":1004,"children":1005},{"style":954},[1006],{"type":50,"value":1007}," do\n",{"type":45,"tag":274,"props":1009,"children":1011},{"class":276,"line":1010},14,[1012,1017,1021,1025,1030,1034,1039,1044,1049,1053,1057],{"type":45,"tag":274,"props":1013,"children":1014},{"style":293},[1015],{"type":50,"value":1016},"  [",{"type":45,"tag":274,"props":1018,"children":1019},{"style":293},[1020],{"type":50,"value":645},{"type":45,"tag":274,"props":1022,"children":1023},{"style":293},[1024],{"type":50,"value":602},{"type":45,"tag":274,"props":1026,"children":1027},{"style":287},[1028],{"type":50,"value":1029},"$f",{"type":45,"tag":274,"props":1031,"children":1032},{"style":293},[1033],{"type":50,"value":301},{"type":45,"tag":274,"props":1035,"children":1036},{"style":293},[1037],{"type":50,"value":1038}," ]",{"type":45,"tag":274,"props":1040,"children":1041},{"style":293},[1042],{"type":50,"value":1043}," &&",{"type":45,"tag":274,"props":1045,"children":1046},{"style":352},[1047],{"type":50,"value":1048}," source",{"type":45,"tag":274,"props":1050,"children":1051},{"style":293},[1052],{"type":50,"value":602},{"type":45,"tag":274,"props":1054,"children":1055},{"style":287},[1056],{"type":50,"value":1029},{"type":45,"tag":274,"props":1058,"children":1059},{"style":293},[1060],{"type":50,"value":312},{"type":45,"tag":274,"props":1062,"children":1064},{"class":276,"line":1063},15,[1065],{"type":45,"tag":274,"props":1066,"children":1067},{"style":954},[1068],{"type":50,"value":1069},"done\n",{"type":45,"tag":274,"props":1071,"children":1073},{"class":276,"line":1072},16,[1074,1078,1082,1086,1090],{"type":45,"tag":274,"props":1075,"children":1076},{"style":589},[1077],{"type":50,"value":141},{"type":45,"tag":274,"props":1079,"children":1080},{"style":293},[1081],{"type":50,"value":602},{"type":45,"tag":274,"props":1083,"children":1084},{"style":287},[1085],{"type":50,"value":607},{"type":45,"tag":274,"props":1087,"children":1088},{"style":304},[1089],{"type":50,"value":847},{"type":45,"tag":274,"props":1091,"children":1092},{"style":293},[1093],{"type":50,"value":312},{"type":45,"tag":53,"props":1095,"children":1096},{},[1097],{"type":50,"value":1098},"Notes:",{"type":45,"tag":332,"props":1100,"children":1101},{},[1102,1121,1139],{"type":45,"tag":105,"props":1103,"children":1104},{},[1105,1107,1113,1115,1120],{"type":50,"value":1106},"The script file lives in the working dir, so ",{"type":45,"tag":59,"props":1108,"children":1110},{"className":1109},[],[1111],{"type":50,"value":1112},"import \"@linear\u002Fsdk\"",{"type":50,"value":1114}," resolves against that dir's ",{"type":45,"tag":59,"props":1116,"children":1118},{"className":1117},[],[1119],{"type":50,"value":496},{"type":50,"value":563},{"type":45,"tag":105,"props":1122,"children":1123},{},[1124,1129,1131,1137],{"type":45,"tag":59,"props":1125,"children":1127},{"className":1126},[],[1128],{"type":50,"value":120},{"type":50,"value":1130}," gives you top-level ",{"type":45,"tag":59,"props":1132,"children":1134},{"className":1133},[],[1135],{"type":50,"value":1136},"await",{"type":50,"value":1138},", so no async wrapper is needed.",{"type":45,"tag":105,"props":1140,"children":1141},{},[1142,1144,1150],{"type":50,"value":1143},"Emit machine-readable output (",{"type":45,"tag":59,"props":1145,"children":1147},{"className":1146},[],[1148],{"type":50,"value":1149},"console.log(JSON.stringify(...))",{"type":50,"value":1151},") when you need to parse results in a later step.",{"type":45,"tag":81,"props":1153,"children":1155},{"id":1154},"handling-auth-failures",[1156],{"type":50,"value":1157},"Handling auth failures",{"type":45,"tag":53,"props":1159,"children":1160},{},[1161,1163,1168,1170,1176],{"type":50,"value":1162},"A missing or invalid key surfaces as an ",{"type":45,"tag":59,"props":1164,"children":1166},{"className":1165},[],[1167],{"type":50,"value":154},{"type":50,"value":1169}," with ",{"type":45,"tag":59,"props":1171,"children":1173},{"className":1172},[],[1174],{"type":50,"value":1175},"status",{"type":50,"value":1177}," 401. Detect it and route to the key setup flow:",{"type":45,"tag":263,"props":1179,"children":1183},{"className":1180,"code":1181,"language":1182,"meta":268,"style":268},"language-js shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","try {\n  const me = await linear.viewer\n  console.log(me.displayName)\n} catch (e) {\n  if (e?.status === 401 || e?.constructor?.name === \"AuthenticationLinearError\") {\n    console.error(\"AUTH_FAILED: set up LINEAR_API_KEY\")\n    process.exit(2)\n  }\n  throw e\n}\n","js",[1184],{"type":45,"tag":59,"props":1185,"children":1186},{"__ignoreMap":268},[1187,1200,1237,1279,1301,1391,1429,1459,1467,1480],{"type":45,"tag":274,"props":1188,"children":1189},{"class":276,"line":277},[1190,1195],{"type":45,"tag":274,"props":1191,"children":1192},{"style":954},[1193],{"type":50,"value":1194},"try",{"type":45,"tag":274,"props":1196,"children":1197},{"style":293},[1198],{"type":50,"value":1199}," {\n",{"type":45,"tag":274,"props":1201,"children":1202},{"class":276,"line":585},[1203,1208,1213,1218,1223,1228,1232],{"type":45,"tag":274,"props":1204,"children":1205},{"style":281},[1206],{"type":50,"value":1207},"  const",{"type":45,"tag":274,"props":1209,"children":1210},{"style":287},[1211],{"type":50,"value":1212}," me",{"type":45,"tag":274,"props":1214,"children":1215},{"style":293},[1216],{"type":50,"value":1217}," =",{"type":45,"tag":274,"props":1219,"children":1220},{"style":954},[1221],{"type":50,"value":1222}," await",{"type":45,"tag":274,"props":1224,"children":1225},{"style":287},[1226],{"type":50,"value":1227}," linear",{"type":45,"tag":274,"props":1229,"children":1230},{"style":293},[1231],{"type":50,"value":563},{"type":45,"tag":274,"props":1233,"children":1234},{"style":287},[1235],{"type":50,"value":1236},"viewer\n",{"type":45,"tag":274,"props":1238,"children":1239},{"class":276,"line":614},[1240,1245,1249,1254,1260,1265,1269,1274],{"type":45,"tag":274,"props":1241,"children":1242},{"style":287},[1243],{"type":50,"value":1244},"  console",{"type":45,"tag":274,"props":1246,"children":1247},{"style":293},[1248],{"type":50,"value":563},{"type":45,"tag":274,"props":1250,"children":1251},{"style":352},[1252],{"type":50,"value":1253},"log",{"type":45,"tag":274,"props":1255,"children":1257},{"style":1256},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[1258],{"type":50,"value":1259},"(",{"type":45,"tag":274,"props":1261,"children":1262},{"style":287},[1263],{"type":50,"value":1264},"me",{"type":45,"tag":274,"props":1266,"children":1267},{"style":293},[1268],{"type":50,"value":563},{"type":45,"tag":274,"props":1270,"children":1271},{"style":287},[1272],{"type":50,"value":1273},"displayName",{"type":45,"tag":274,"props":1275,"children":1276},{"style":1256},[1277],{"type":50,"value":1278},")\n",{"type":45,"tag":274,"props":1280,"children":1281},{"class":276,"line":32},[1282,1286,1291,1296],{"type":45,"tag":274,"props":1283,"children":1284},{"style":293},[1285],{"type":50,"value":573},{"type":45,"tag":274,"props":1287,"children":1288},{"style":954},[1289],{"type":50,"value":1290}," catch",{"type":45,"tag":274,"props":1292,"children":1293},{"style":287},[1294],{"type":50,"value":1295}," (e) ",{"type":45,"tag":274,"props":1297,"children":1298},{"style":293},[1299],{"type":50,"value":1300},"{\n",{"type":45,"tag":274,"props":1302,"children":1303},{"class":276,"line":688},[1304,1309,1314,1319,1324,1328,1333,1339,1343,1348,1352,1357,1361,1366,1370,1374,1378,1382,1387],{"type":45,"tag":274,"props":1305,"children":1306},{"style":954},[1307],{"type":50,"value":1308},"  if",{"type":45,"tag":274,"props":1310,"children":1311},{"style":1256},[1312],{"type":50,"value":1313}," (",{"type":45,"tag":274,"props":1315,"children":1316},{"style":287},[1317],{"type":50,"value":1318},"e",{"type":45,"tag":274,"props":1320,"children":1321},{"style":293},[1322],{"type":50,"value":1323},"?.",{"type":45,"tag":274,"props":1325,"children":1326},{"style":287},[1327],{"type":50,"value":1175},{"type":45,"tag":274,"props":1329,"children":1330},{"style":293},[1331],{"type":50,"value":1332}," ===",{"type":45,"tag":274,"props":1334,"children":1336},{"style":1335},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[1337],{"type":50,"value":1338}," 401",{"type":45,"tag":274,"props":1340,"children":1341},{"style":293},[1342],{"type":50,"value":660},{"type":45,"tag":274,"props":1344,"children":1345},{"style":287},[1346],{"type":50,"value":1347}," e",{"type":45,"tag":274,"props":1349,"children":1350},{"style":293},[1351],{"type":50,"value":1323},{"type":45,"tag":274,"props":1353,"children":1354},{"style":287},[1355],{"type":50,"value":1356},"constructor",{"type":45,"tag":274,"props":1358,"children":1359},{"style":293},[1360],{"type":50,"value":1323},{"type":45,"tag":274,"props":1362,"children":1363},{"style":287},[1364],{"type":50,"value":1365},"name",{"type":45,"tag":274,"props":1367,"children":1368},{"style":293},[1369],{"type":50,"value":1332},{"type":45,"tag":274,"props":1371,"children":1372},{"style":293},[1373],{"type":50,"value":602},{"type":45,"tag":274,"props":1375,"children":1376},{"style":304},[1377],{"type":50,"value":154},{"type":45,"tag":274,"props":1379,"children":1380},{"style":293},[1381],{"type":50,"value":301},{"type":45,"tag":274,"props":1383,"children":1384},{"style":1256},[1385],{"type":50,"value":1386},") ",{"type":45,"tag":274,"props":1388,"children":1389},{"style":293},[1390],{"type":50,"value":1300},{"type":45,"tag":274,"props":1392,"children":1393},{"class":276,"line":889},[1394,1399,1403,1408,1412,1416,1421,1425],{"type":45,"tag":274,"props":1395,"children":1396},{"style":287},[1397],{"type":50,"value":1398},"    console",{"type":45,"tag":274,"props":1400,"children":1401},{"style":293},[1402],{"type":50,"value":563},{"type":45,"tag":274,"props":1404,"children":1405},{"style":352},[1406],{"type":50,"value":1407},"error",{"type":45,"tag":274,"props":1409,"children":1410},{"style":1256},[1411],{"type":50,"value":1259},{"type":45,"tag":274,"props":1413,"children":1414},{"style":293},[1415],{"type":50,"value":301},{"type":45,"tag":274,"props":1417,"children":1418},{"style":304},[1419],{"type":50,"value":1420},"AUTH_FAILED: set up LINEAR_API_KEY",{"type":45,"tag":274,"props":1422,"children":1423},{"style":293},[1424],{"type":50,"value":301},{"type":45,"tag":274,"props":1426,"children":1427},{"style":1256},[1428],{"type":50,"value":1278},{"type":45,"tag":274,"props":1430,"children":1431},{"class":276,"line":897},[1432,1437,1441,1446,1450,1455],{"type":45,"tag":274,"props":1433,"children":1434},{"style":287},[1435],{"type":50,"value":1436},"    process",{"type":45,"tag":274,"props":1438,"children":1439},{"style":293},[1440],{"type":50,"value":563},{"type":45,"tag":274,"props":1442,"children":1443},{"style":352},[1444],{"type":50,"value":1445},"exit",{"type":45,"tag":274,"props":1447,"children":1448},{"style":1256},[1449],{"type":50,"value":1259},{"type":45,"tag":274,"props":1451,"children":1452},{"style":1335},[1453],{"type":50,"value":1454},"2",{"type":45,"tag":274,"props":1456,"children":1457},{"style":1256},[1458],{"type":50,"value":1278},{"type":45,"tag":274,"props":1460,"children":1461},{"class":276,"line":906},[1462],{"type":45,"tag":274,"props":1463,"children":1464},{"style":293},[1465],{"type":50,"value":1466},"  }\n",{"type":45,"tag":274,"props":1468,"children":1469},{"class":276,"line":915},[1470,1475],{"type":45,"tag":274,"props":1471,"children":1472},{"style":954},[1473],{"type":50,"value":1474},"  throw",{"type":45,"tag":274,"props":1476,"children":1477},{"style":287},[1478],{"type":50,"value":1479}," e\n",{"type":45,"tag":274,"props":1481,"children":1482},{"class":276,"line":28},[1483],{"type":45,"tag":274,"props":1484,"children":1485},{"style":293},[1486],{"type":50,"value":938},{"type":45,"tag":53,"props":1488,"children":1489},{},[1490,1492,1498],{"type":50,"value":1491},"If you see ",{"type":45,"tag":59,"props":1493,"children":1495},{"className":1494},[],[1496],{"type":50,"value":1497},"AUTH_FAILED",{"type":50,"value":1499}," (or the script crashes before any data), recover in this order rather than jumping straight to creating a key:",{"type":45,"tag":101,"props":1501,"children":1502},{},[1503,1644],{"type":45,"tag":105,"props":1504,"children":1505},{},[1506,1508,1639,1642],{"type":50,"value":1507},"Source the shell profiles and retry once. The key may already be persisted in a profile file that this shell never sourced. Pull it in and re-run the same script:",{"type":45,"tag":263,"props":1509,"children":1511},{"className":265,"code":1510,"language":267,"meta":268,"style":268},"for f in ~\u002F.zshenv ~\u002F.zshrc ~\u002F.zprofile ~\u002F.profile ~\u002F.bashrc ~\u002F.bash_profile; do\n  [ -f \"$f\" ] && source \"$f\"\ndone\nnode \"$LINEAR_DIR\u002Ftask.mjs\"\n",[1512],{"type":45,"tag":59,"props":1513,"children":1514},{"__ignoreMap":268},[1515,1562,1609,1616],{"type":45,"tag":274,"props":1516,"children":1517},{"class":276,"line":277},[1518,1522,1526,1530,1534,1538,1542,1546,1550,1554,1558],{"type":45,"tag":274,"props":1519,"children":1520},{"style":954},[1521],{"type":50,"value":957},{"type":45,"tag":274,"props":1523,"children":1524},{"style":287},[1525],{"type":50,"value":962},{"type":45,"tag":274,"props":1527,"children":1528},{"style":954},[1529],{"type":50,"value":967},{"type":45,"tag":274,"props":1531,"children":1532},{"style":304},[1533],{"type":50,"value":972},{"type":45,"tag":274,"props":1535,"children":1536},{"style":304},[1537],{"type":50,"value":977},{"type":45,"tag":274,"props":1539,"children":1540},{"style":304},[1541],{"type":50,"value":982},{"type":45,"tag":274,"props":1543,"children":1544},{"style":304},[1545],{"type":50,"value":987},{"type":45,"tag":274,"props":1547,"children":1548},{"style":304},[1549],{"type":50,"value":992},{"type":45,"tag":274,"props":1551,"children":1552},{"style":304},[1553],{"type":50,"value":997},{"type":45,"tag":274,"props":1555,"children":1556},{"style":293},[1557],{"type":50,"value":1002},{"type":45,"tag":274,"props":1559,"children":1560},{"style":954},[1561],{"type":50,"value":1007},{"type":45,"tag":274,"props":1563,"children":1564},{"class":276,"line":585},[1565,1569,1573,1577,1581,1585,1589,1593,1597,1601,1605],{"type":45,"tag":274,"props":1566,"children":1567},{"style":293},[1568],{"type":50,"value":1016},{"type":45,"tag":274,"props":1570,"children":1571},{"style":293},[1572],{"type":50,"value":645},{"type":45,"tag":274,"props":1574,"children":1575},{"style":293},[1576],{"type":50,"value":602},{"type":45,"tag":274,"props":1578,"children":1579},{"style":287},[1580],{"type":50,"value":1029},{"type":45,"tag":274,"props":1582,"children":1583},{"style":293},[1584],{"type":50,"value":301},{"type":45,"tag":274,"props":1586,"children":1587},{"style":293},[1588],{"type":50,"value":1038},{"type":45,"tag":274,"props":1590,"children":1591},{"style":293},[1592],{"type":50,"value":1043},{"type":45,"tag":274,"props":1594,"children":1595},{"style":352},[1596],{"type":50,"value":1048},{"type":45,"tag":274,"props":1598,"children":1599},{"style":293},[1600],{"type":50,"value":602},{"type":45,"tag":274,"props":1602,"children":1603},{"style":287},[1604],{"type":50,"value":1029},{"type":45,"tag":274,"props":1606,"children":1607},{"style":293},[1608],{"type":50,"value":312},{"type":45,"tag":274,"props":1610,"children":1611},{"class":276,"line":614},[1612],{"type":45,"tag":274,"props":1613,"children":1614},{"style":954},[1615],{"type":50,"value":1069},{"type":45,"tag":274,"props":1617,"children":1618},{"class":276,"line":32},[1619,1623,1627,1631,1635],{"type":45,"tag":274,"props":1620,"children":1621},{"style":589},[1622],{"type":50,"value":141},{"type":45,"tag":274,"props":1624,"children":1625},{"style":293},[1626],{"type":50,"value":602},{"type":45,"tag":274,"props":1628,"children":1629},{"style":287},[1630],{"type":50,"value":607},{"type":45,"tag":274,"props":1632,"children":1633},{"style":304},[1634],{"type":50,"value":847},{"type":45,"tag":274,"props":1636,"children":1637},{"style":293},[1638],{"type":50,"value":312},{"type":45,"tag":326,"props":1640,"children":1641},{},[],{"type":50,"value":1643},"(If you already ran with the canonical Execution pattern preamble, the profiles were sourced, so this retry will only help if you ran without it.)",{"type":45,"tag":105,"props":1645,"children":1646},{},[1647],{"type":50,"value":1648},"Only if it still auth-fails, the key is genuinely missing or invalid. Now do the Personal API key setup with the user (create and persist a new key), then rerun.",{"type":45,"tag":81,"props":1650,"children":1652},{"id":1651},"common-operations",[1653],{"type":50,"value":1654},"Common operations",{"type":45,"tag":53,"props":1656,"children":1657},{},[1658,1660,1666,1668,1673],{"type":50,"value":1659},"Concise recipes are inline below. Fuller examples (filtering, pagination loops, closing issues via workflow states, batch operations) are in ",{"type":45,"tag":59,"props":1661,"children":1663},{"className":1662},[],[1664],{"type":50,"value":1665},"references\u002Frecipes.md",{"type":50,"value":1667},". The doc index is in ",{"type":45,"tag":59,"props":1669,"children":1671},{"className":1670},[],[1672],{"type":50,"value":77},{"type":50,"value":563},{"type":45,"tag":53,"props":1675,"children":1676},{},[1677],{"type":50,"value":1678},"Read:",{"type":45,"tag":263,"props":1680,"children":1682},{"className":1180,"code":1681,"language":1182,"meta":268,"style":268},"\u002F\u002F Current user\nconst me = await linear.viewer\n\n\u002F\u002F List issues (newest first), with a filter\nconst issues = await linear.issues({\n  first: 25,\n  filter: { state: { type: { eq: \"started\" } } },\n})\n\n\u002F\u002F A single issue by UUID\nconst issue = await linear.issue(\"UUID\")\n\n\u002F\u002F Teams, users, projects\nconst teams = await linear.teams()\nconst users = await linear.users()\nconst projects = await linear.projects({ first: 50 })\n",[1683],{"type":45,"tag":59,"props":1684,"children":1685},{"__ignoreMap":268},[1686,1695,1728,1735,1743,1784,1807,1886,1897,1904,1912,1966,1973,1981,2019,2056],{"type":45,"tag":274,"props":1687,"children":1688},{"class":276,"line":277},[1689],{"type":45,"tag":274,"props":1690,"children":1692},{"style":1691},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[1693],{"type":50,"value":1694},"\u002F\u002F Current user\n",{"type":45,"tag":274,"props":1696,"children":1697},{"class":276,"line":585},[1698,1703,1708,1712,1716,1720,1724],{"type":45,"tag":274,"props":1699,"children":1700},{"style":281},[1701],{"type":50,"value":1702},"const",{"type":45,"tag":274,"props":1704,"children":1705},{"style":287},[1706],{"type":50,"value":1707}," me ",{"type":45,"tag":274,"props":1709,"children":1710},{"style":293},[1711],{"type":50,"value":296},{"type":45,"tag":274,"props":1713,"children":1714},{"style":954},[1715],{"type":50,"value":1222},{"type":45,"tag":274,"props":1717,"children":1718},{"style":287},[1719],{"type":50,"value":1227},{"type":45,"tag":274,"props":1721,"children":1722},{"style":293},[1723],{"type":50,"value":563},{"type":45,"tag":274,"props":1725,"children":1726},{"style":287},[1727],{"type":50,"value":1236},{"type":45,"tag":274,"props":1729,"children":1730},{"class":276,"line":614},[1731],{"type":45,"tag":274,"props":1732,"children":1733},{"emptyLinePlaceholder":875},[1734],{"type":50,"value":878},{"type":45,"tag":274,"props":1736,"children":1737},{"class":276,"line":32},[1738],{"type":45,"tag":274,"props":1739,"children":1740},{"style":1691},[1741],{"type":50,"value":1742},"\u002F\u002F List issues (newest first), with a filter\n",{"type":45,"tag":274,"props":1744,"children":1745},{"class":276,"line":688},[1746,1750,1755,1759,1763,1767,1771,1776,1780],{"type":45,"tag":274,"props":1747,"children":1748},{"style":281},[1749],{"type":50,"value":1702},{"type":45,"tag":274,"props":1751,"children":1752},{"style":287},[1753],{"type":50,"value":1754}," issues ",{"type":45,"tag":274,"props":1756,"children":1757},{"style":293},[1758],{"type":50,"value":296},{"type":45,"tag":274,"props":1760,"children":1761},{"style":954},[1762],{"type":50,"value":1222},{"type":45,"tag":274,"props":1764,"children":1765},{"style":287},[1766],{"type":50,"value":1227},{"type":45,"tag":274,"props":1768,"children":1769},{"style":293},[1770],{"type":50,"value":563},{"type":45,"tag":274,"props":1772,"children":1773},{"style":352},[1774],{"type":50,"value":1775},"issues",{"type":45,"tag":274,"props":1777,"children":1778},{"style":287},[1779],{"type":50,"value":1259},{"type":45,"tag":274,"props":1781,"children":1782},{"style":293},[1783],{"type":50,"value":1300},{"type":45,"tag":274,"props":1785,"children":1786},{"class":276,"line":889},[1787,1792,1797,1802],{"type":45,"tag":274,"props":1788,"children":1789},{"style":1256},[1790],{"type":50,"value":1791},"  first",{"type":45,"tag":274,"props":1793,"children":1794},{"style":293},[1795],{"type":50,"value":1796},":",{"type":45,"tag":274,"props":1798,"children":1799},{"style":1335},[1800],{"type":50,"value":1801}," 25",{"type":45,"tag":274,"props":1803,"children":1804},{"style":293},[1805],{"type":50,"value":1806},",\n",{"type":45,"tag":274,"props":1808,"children":1809},{"class":276,"line":897},[1810,1815,1819,1824,1829,1833,1837,1842,1846,1850,1855,1859,1863,1868,1872,1877,1881],{"type":45,"tag":274,"props":1811,"children":1812},{"style":1256},[1813],{"type":50,"value":1814},"  filter",{"type":45,"tag":274,"props":1816,"children":1817},{"style":293},[1818],{"type":50,"value":1796},{"type":45,"tag":274,"props":1820,"children":1821},{"style":293},[1822],{"type":50,"value":1823}," {",{"type":45,"tag":274,"props":1825,"children":1826},{"style":1256},[1827],{"type":50,"value":1828}," state",{"type":45,"tag":274,"props":1830,"children":1831},{"style":293},[1832],{"type":50,"value":1796},{"type":45,"tag":274,"props":1834,"children":1835},{"style":293},[1836],{"type":50,"value":1823},{"type":45,"tag":274,"props":1838,"children":1839},{"style":1256},[1840],{"type":50,"value":1841}," type",{"type":45,"tag":274,"props":1843,"children":1844},{"style":293},[1845],{"type":50,"value":1796},{"type":45,"tag":274,"props":1847,"children":1848},{"style":293},[1849],{"type":50,"value":1823},{"type":45,"tag":274,"props":1851,"children":1852},{"style":1256},[1853],{"type":50,"value":1854}," eq",{"type":45,"tag":274,"props":1856,"children":1857},{"style":293},[1858],{"type":50,"value":1796},{"type":45,"tag":274,"props":1860,"children":1861},{"style":293},[1862],{"type":50,"value":602},{"type":45,"tag":274,"props":1864,"children":1865},{"style":304},[1866],{"type":50,"value":1867},"started",{"type":45,"tag":274,"props":1869,"children":1870},{"style":293},[1871],{"type":50,"value":301},{"type":45,"tag":274,"props":1873,"children":1874},{"style":293},[1875],{"type":50,"value":1876}," }",{"type":45,"tag":274,"props":1878,"children":1879},{"style":293},[1880],{"type":50,"value":1876},{"type":45,"tag":274,"props":1882,"children":1883},{"style":293},[1884],{"type":50,"value":1885}," },\n",{"type":45,"tag":274,"props":1887,"children":1888},{"class":276,"line":906},[1889,1893],{"type":45,"tag":274,"props":1890,"children":1891},{"style":293},[1892],{"type":50,"value":573},{"type":45,"tag":274,"props":1894,"children":1895},{"style":287},[1896],{"type":50,"value":1278},{"type":45,"tag":274,"props":1898,"children":1899},{"class":276,"line":915},[1900],{"type":45,"tag":274,"props":1901,"children":1902},{"emptyLinePlaceholder":875},[1903],{"type":50,"value":878},{"type":45,"tag":274,"props":1905,"children":1906},{"class":276,"line":28},[1907],{"type":45,"tag":274,"props":1908,"children":1909},{"style":1691},[1910],{"type":50,"value":1911},"\u002F\u002F A single issue by UUID\n",{"type":45,"tag":274,"props":1913,"children":1914},{"class":276,"line":932},[1915,1919,1924,1928,1932,1936,1940,1945,1949,1953,1958,1962],{"type":45,"tag":274,"props":1916,"children":1917},{"style":281},[1918],{"type":50,"value":1702},{"type":45,"tag":274,"props":1920,"children":1921},{"style":287},[1922],{"type":50,"value":1923}," issue ",{"type":45,"tag":274,"props":1925,"children":1926},{"style":293},[1927],{"type":50,"value":296},{"type":45,"tag":274,"props":1929,"children":1930},{"style":954},[1931],{"type":50,"value":1222},{"type":45,"tag":274,"props":1933,"children":1934},{"style":287},[1935],{"type":50,"value":1227},{"type":45,"tag":274,"props":1937,"children":1938},{"style":293},[1939],{"type":50,"value":563},{"type":45,"tag":274,"props":1941,"children":1942},{"style":352},[1943],{"type":50,"value":1944},"issue",{"type":45,"tag":274,"props":1946,"children":1947},{"style":287},[1948],{"type":50,"value":1259},{"type":45,"tag":274,"props":1950,"children":1951},{"style":293},[1952],{"type":50,"value":301},{"type":45,"tag":274,"props":1954,"children":1955},{"style":304},[1956],{"type":50,"value":1957},"UUID",{"type":45,"tag":274,"props":1959,"children":1960},{"style":293},[1961],{"type":50,"value":301},{"type":45,"tag":274,"props":1963,"children":1964},{"style":287},[1965],{"type":50,"value":1278},{"type":45,"tag":274,"props":1967,"children":1968},{"class":276,"line":941},[1969],{"type":45,"tag":274,"props":1970,"children":1971},{"emptyLinePlaceholder":875},[1972],{"type":50,"value":878},{"type":45,"tag":274,"props":1974,"children":1975},{"class":276,"line":950},[1976],{"type":45,"tag":274,"props":1977,"children":1978},{"style":1691},[1979],{"type":50,"value":1980},"\u002F\u002F Teams, users, projects\n",{"type":45,"tag":274,"props":1982,"children":1983},{"class":276,"line":1010},[1984,1988,1993,1997,2001,2005,2009,2014],{"type":45,"tag":274,"props":1985,"children":1986},{"style":281},[1987],{"type":50,"value":1702},{"type":45,"tag":274,"props":1989,"children":1990},{"style":287},[1991],{"type":50,"value":1992}," teams ",{"type":45,"tag":274,"props":1994,"children":1995},{"style":293},[1996],{"type":50,"value":296},{"type":45,"tag":274,"props":1998,"children":1999},{"style":954},[2000],{"type":50,"value":1222},{"type":45,"tag":274,"props":2002,"children":2003},{"style":287},[2004],{"type":50,"value":1227},{"type":45,"tag":274,"props":2006,"children":2007},{"style":293},[2008],{"type":50,"value":563},{"type":45,"tag":274,"props":2010,"children":2011},{"style":352},[2012],{"type":50,"value":2013},"teams",{"type":45,"tag":274,"props":2015,"children":2016},{"style":287},[2017],{"type":50,"value":2018},"()\n",{"type":45,"tag":274,"props":2020,"children":2021},{"class":276,"line":1063},[2022,2026,2031,2035,2039,2043,2047,2052],{"type":45,"tag":274,"props":2023,"children":2024},{"style":281},[2025],{"type":50,"value":1702},{"type":45,"tag":274,"props":2027,"children":2028},{"style":287},[2029],{"type":50,"value":2030}," users ",{"type":45,"tag":274,"props":2032,"children":2033},{"style":293},[2034],{"type":50,"value":296},{"type":45,"tag":274,"props":2036,"children":2037},{"style":954},[2038],{"type":50,"value":1222},{"type":45,"tag":274,"props":2040,"children":2041},{"style":287},[2042],{"type":50,"value":1227},{"type":45,"tag":274,"props":2044,"children":2045},{"style":293},[2046],{"type":50,"value":563},{"type":45,"tag":274,"props":2048,"children":2049},{"style":352},[2050],{"type":50,"value":2051},"users",{"type":45,"tag":274,"props":2053,"children":2054},{"style":287},[2055],{"type":50,"value":2018},{"type":45,"tag":274,"props":2057,"children":2058},{"class":276,"line":1072},[2059,2063,2068,2072,2076,2080,2084,2089,2093,2098,2103,2107,2112,2116],{"type":45,"tag":274,"props":2060,"children":2061},{"style":281},[2062],{"type":50,"value":1702},{"type":45,"tag":274,"props":2064,"children":2065},{"style":287},[2066],{"type":50,"value":2067}," projects ",{"type":45,"tag":274,"props":2069,"children":2070},{"style":293},[2071],{"type":50,"value":296},{"type":45,"tag":274,"props":2073,"children":2074},{"style":954},[2075],{"type":50,"value":1222},{"type":45,"tag":274,"props":2077,"children":2078},{"style":287},[2079],{"type":50,"value":1227},{"type":45,"tag":274,"props":2081,"children":2082},{"style":293},[2083],{"type":50,"value":563},{"type":45,"tag":274,"props":2085,"children":2086},{"style":352},[2087],{"type":50,"value":2088},"projects",{"type":45,"tag":274,"props":2090,"children":2091},{"style":287},[2092],{"type":50,"value":1259},{"type":45,"tag":274,"props":2094,"children":2095},{"style":293},[2096],{"type":50,"value":2097},"{",{"type":45,"tag":274,"props":2099,"children":2100},{"style":1256},[2101],{"type":50,"value":2102}," first",{"type":45,"tag":274,"props":2104,"children":2105},{"style":293},[2106],{"type":50,"value":1796},{"type":45,"tag":274,"props":2108,"children":2109},{"style":1335},[2110],{"type":50,"value":2111}," 50",{"type":45,"tag":274,"props":2113,"children":2114},{"style":293},[2115],{"type":50,"value":1876},{"type":45,"tag":274,"props":2117,"children":2118},{"style":287},[2119],{"type":50,"value":1278},{"type":45,"tag":53,"props":2121,"children":2122},{},[2123,2125,2131],{"type":50,"value":2124},"Write (mutations return a payload with ",{"type":45,"tag":59,"props":2126,"children":2128},{"className":2127},[],[2129],{"type":50,"value":2130},"success",{"type":50,"value":2132}," and the entity, often as a promise):",{"type":45,"tag":263,"props":2134,"children":2136},{"className":1180,"code":2135,"language":1182,"meta":268,"style":268},"\u002F\u002F Create\nconst created = await linear.createIssue({\n  teamId: \"TEAM_UUID\",\n  title: \"Title\",\n  description: \"Markdown body\",\n})\nconst newIssue = await created.issue\n\n\u002F\u002F Update (e.g. retitle, reassign)\nawait linear.updateIssue(\"ISSUE_UUID\", { title: \"New title\", assigneeId: \"USER_UUID\" })\n\n\u002F\u002F Comment\nawait linear.createComment({ issueId: \"ISSUE_UUID\", body: \"Comment text\" })\n",[2137],{"type":45,"tag":59,"props":2138,"children":2139},{"__ignoreMap":268},[2140,2148,2189,2218,2247,2276,2287,2321,2328,2336,2438,2445,2453],{"type":45,"tag":274,"props":2141,"children":2142},{"class":276,"line":277},[2143],{"type":45,"tag":274,"props":2144,"children":2145},{"style":1691},[2146],{"type":50,"value":2147},"\u002F\u002F Create\n",{"type":45,"tag":274,"props":2149,"children":2150},{"class":276,"line":585},[2151,2155,2160,2164,2168,2172,2176,2181,2185],{"type":45,"tag":274,"props":2152,"children":2153},{"style":281},[2154],{"type":50,"value":1702},{"type":45,"tag":274,"props":2156,"children":2157},{"style":287},[2158],{"type":50,"value":2159}," created ",{"type":45,"tag":274,"props":2161,"children":2162},{"style":293},[2163],{"type":50,"value":296},{"type":45,"tag":274,"props":2165,"children":2166},{"style":954},[2167],{"type":50,"value":1222},{"type":45,"tag":274,"props":2169,"children":2170},{"style":287},[2171],{"type":50,"value":1227},{"type":45,"tag":274,"props":2173,"children":2174},{"style":293},[2175],{"type":50,"value":563},{"type":45,"tag":274,"props":2177,"children":2178},{"style":352},[2179],{"type":50,"value":2180},"createIssue",{"type":45,"tag":274,"props":2182,"children":2183},{"style":287},[2184],{"type":50,"value":1259},{"type":45,"tag":274,"props":2186,"children":2187},{"style":293},[2188],{"type":50,"value":1300},{"type":45,"tag":274,"props":2190,"children":2191},{"class":276,"line":614},[2192,2197,2201,2205,2210,2214],{"type":45,"tag":274,"props":2193,"children":2194},{"style":1256},[2195],{"type":50,"value":2196},"  teamId",{"type":45,"tag":274,"props":2198,"children":2199},{"style":293},[2200],{"type":50,"value":1796},{"type":45,"tag":274,"props":2202,"children":2203},{"style":293},[2204],{"type":50,"value":602},{"type":45,"tag":274,"props":2206,"children":2207},{"style":304},[2208],{"type":50,"value":2209},"TEAM_UUID",{"type":45,"tag":274,"props":2211,"children":2212},{"style":293},[2213],{"type":50,"value":301},{"type":45,"tag":274,"props":2215,"children":2216},{"style":293},[2217],{"type":50,"value":1806},{"type":45,"tag":274,"props":2219,"children":2220},{"class":276,"line":32},[2221,2226,2230,2234,2239,2243],{"type":45,"tag":274,"props":2222,"children":2223},{"style":1256},[2224],{"type":50,"value":2225},"  title",{"type":45,"tag":274,"props":2227,"children":2228},{"style":293},[2229],{"type":50,"value":1796},{"type":45,"tag":274,"props":2231,"children":2232},{"style":293},[2233],{"type":50,"value":602},{"type":45,"tag":274,"props":2235,"children":2236},{"style":304},[2237],{"type":50,"value":2238},"Title",{"type":45,"tag":274,"props":2240,"children":2241},{"style":293},[2242],{"type":50,"value":301},{"type":45,"tag":274,"props":2244,"children":2245},{"style":293},[2246],{"type":50,"value":1806},{"type":45,"tag":274,"props":2248,"children":2249},{"class":276,"line":688},[2250,2255,2259,2263,2268,2272],{"type":45,"tag":274,"props":2251,"children":2252},{"style":1256},[2253],{"type":50,"value":2254},"  description",{"type":45,"tag":274,"props":2256,"children":2257},{"style":293},[2258],{"type":50,"value":1796},{"type":45,"tag":274,"props":2260,"children":2261},{"style":293},[2262],{"type":50,"value":602},{"type":45,"tag":274,"props":2264,"children":2265},{"style":304},[2266],{"type":50,"value":2267},"Markdown body",{"type":45,"tag":274,"props":2269,"children":2270},{"style":293},[2271],{"type":50,"value":301},{"type":45,"tag":274,"props":2273,"children":2274},{"style":293},[2275],{"type":50,"value":1806},{"type":45,"tag":274,"props":2277,"children":2278},{"class":276,"line":889},[2279,2283],{"type":45,"tag":274,"props":2280,"children":2281},{"style":293},[2282],{"type":50,"value":573},{"type":45,"tag":274,"props":2284,"children":2285},{"style":287},[2286],{"type":50,"value":1278},{"type":45,"tag":274,"props":2288,"children":2289},{"class":276,"line":897},[2290,2294,2299,2303,2307,2312,2316],{"type":45,"tag":274,"props":2291,"children":2292},{"style":281},[2293],{"type":50,"value":1702},{"type":45,"tag":274,"props":2295,"children":2296},{"style":287},[2297],{"type":50,"value":2298}," newIssue ",{"type":45,"tag":274,"props":2300,"children":2301},{"style":293},[2302],{"type":50,"value":296},{"type":45,"tag":274,"props":2304,"children":2305},{"style":954},[2306],{"type":50,"value":1222},{"type":45,"tag":274,"props":2308,"children":2309},{"style":287},[2310],{"type":50,"value":2311}," created",{"type":45,"tag":274,"props":2313,"children":2314},{"style":293},[2315],{"type":50,"value":563},{"type":45,"tag":274,"props":2317,"children":2318},{"style":287},[2319],{"type":50,"value":2320},"issue\n",{"type":45,"tag":274,"props":2322,"children":2323},{"class":276,"line":906},[2324],{"type":45,"tag":274,"props":2325,"children":2326},{"emptyLinePlaceholder":875},[2327],{"type":50,"value":878},{"type":45,"tag":274,"props":2329,"children":2330},{"class":276,"line":915},[2331],{"type":45,"tag":274,"props":2332,"children":2333},{"style":1691},[2334],{"type":50,"value":2335},"\u002F\u002F Update (e.g. retitle, reassign)\n",{"type":45,"tag":274,"props":2337,"children":2338},{"class":276,"line":28},[2339,2343,2347,2351,2356,2360,2364,2369,2373,2378,2382,2387,2391,2395,2400,2404,2408,2413,2417,2421,2426,2430,2434],{"type":45,"tag":274,"props":2340,"children":2341},{"style":954},[2342],{"type":50,"value":1136},{"type":45,"tag":274,"props":2344,"children":2345},{"style":287},[2346],{"type":50,"value":1227},{"type":45,"tag":274,"props":2348,"children":2349},{"style":293},[2350],{"type":50,"value":563},{"type":45,"tag":274,"props":2352,"children":2353},{"style":352},[2354],{"type":50,"value":2355},"updateIssue",{"type":45,"tag":274,"props":2357,"children":2358},{"style":287},[2359],{"type":50,"value":1259},{"type":45,"tag":274,"props":2361,"children":2362},{"style":293},[2363],{"type":50,"value":301},{"type":45,"tag":274,"props":2365,"children":2366},{"style":304},[2367],{"type":50,"value":2368},"ISSUE_UUID",{"type":45,"tag":274,"props":2370,"children":2371},{"style":293},[2372],{"type":50,"value":301},{"type":45,"tag":274,"props":2374,"children":2375},{"style":293},[2376],{"type":50,"value":2377},",",{"type":45,"tag":274,"props":2379,"children":2380},{"style":293},[2381],{"type":50,"value":1823},{"type":45,"tag":274,"props":2383,"children":2384},{"style":1256},[2385],{"type":50,"value":2386}," title",{"type":45,"tag":274,"props":2388,"children":2389},{"style":293},[2390],{"type":50,"value":1796},{"type":45,"tag":274,"props":2392,"children":2393},{"style":293},[2394],{"type":50,"value":602},{"type":45,"tag":274,"props":2396,"children":2397},{"style":304},[2398],{"type":50,"value":2399},"New title",{"type":45,"tag":274,"props":2401,"children":2402},{"style":293},[2403],{"type":50,"value":301},{"type":45,"tag":274,"props":2405,"children":2406},{"style":293},[2407],{"type":50,"value":2377},{"type":45,"tag":274,"props":2409,"children":2410},{"style":1256},[2411],{"type":50,"value":2412}," assigneeId",{"type":45,"tag":274,"props":2414,"children":2415},{"style":293},[2416],{"type":50,"value":1796},{"type":45,"tag":274,"props":2418,"children":2419},{"style":293},[2420],{"type":50,"value":602},{"type":45,"tag":274,"props":2422,"children":2423},{"style":304},[2424],{"type":50,"value":2425},"USER_UUID",{"type":45,"tag":274,"props":2427,"children":2428},{"style":293},[2429],{"type":50,"value":301},{"type":45,"tag":274,"props":2431,"children":2432},{"style":293},[2433],{"type":50,"value":1876},{"type":45,"tag":274,"props":2435,"children":2436},{"style":287},[2437],{"type":50,"value":1278},{"type":45,"tag":274,"props":2439,"children":2440},{"class":276,"line":932},[2441],{"type":45,"tag":274,"props":2442,"children":2443},{"emptyLinePlaceholder":875},[2444],{"type":50,"value":878},{"type":45,"tag":274,"props":2446,"children":2447},{"class":276,"line":941},[2448],{"type":45,"tag":274,"props":2449,"children":2450},{"style":1691},[2451],{"type":50,"value":2452},"\u002F\u002F Comment\n",{"type":45,"tag":274,"props":2454,"children":2455},{"class":276,"line":950},[2456,2460,2464,2468,2473,2477,2481,2486,2490,2494,2498,2502,2506,2511,2515,2519,2524,2528,2532],{"type":45,"tag":274,"props":2457,"children":2458},{"style":954},[2459],{"type":50,"value":1136},{"type":45,"tag":274,"props":2461,"children":2462},{"style":287},[2463],{"type":50,"value":1227},{"type":45,"tag":274,"props":2465,"children":2466},{"style":293},[2467],{"type":50,"value":563},{"type":45,"tag":274,"props":2469,"children":2470},{"style":352},[2471],{"type":50,"value":2472},"createComment",{"type":45,"tag":274,"props":2474,"children":2475},{"style":287},[2476],{"type":50,"value":1259},{"type":45,"tag":274,"props":2478,"children":2479},{"style":293},[2480],{"type":50,"value":2097},{"type":45,"tag":274,"props":2482,"children":2483},{"style":1256},[2484],{"type":50,"value":2485}," issueId",{"type":45,"tag":274,"props":2487,"children":2488},{"style":293},[2489],{"type":50,"value":1796},{"type":45,"tag":274,"props":2491,"children":2492},{"style":293},[2493],{"type":50,"value":602},{"type":45,"tag":274,"props":2495,"children":2496},{"style":304},[2497],{"type":50,"value":2368},{"type":45,"tag":274,"props":2499,"children":2500},{"style":293},[2501],{"type":50,"value":301},{"type":45,"tag":274,"props":2503,"children":2504},{"style":293},[2505],{"type":50,"value":2377},{"type":45,"tag":274,"props":2507,"children":2508},{"style":1256},[2509],{"type":50,"value":2510}," body",{"type":45,"tag":274,"props":2512,"children":2513},{"style":293},[2514],{"type":50,"value":1796},{"type":45,"tag":274,"props":2516,"children":2517},{"style":293},[2518],{"type":50,"value":602},{"type":45,"tag":274,"props":2520,"children":2521},{"style":304},[2522],{"type":50,"value":2523},"Comment text",{"type":45,"tag":274,"props":2525,"children":2526},{"style":293},[2527],{"type":50,"value":301},{"type":45,"tag":274,"props":2529,"children":2530},{"style":293},[2531],{"type":50,"value":1876},{"type":45,"tag":274,"props":2533,"children":2534},{"style":287},[2535],{"type":50,"value":1278},{"type":45,"tag":53,"props":2537,"children":2538},{},[2539,2541,2547,2549,2555,2557,2562],{"type":50,"value":2540},"To resolve human inputs to IDs (team key like ",{"type":45,"tag":59,"props":2542,"children":2544},{"className":2543},[],[2545],{"type":50,"value":2546},"ENG",{"type":50,"value":2548},", a workflow state name like ",{"type":45,"tag":59,"props":2550,"children":2552},{"className":2551},[],[2553],{"type":50,"value":2554},"Done",{"type":50,"value":2556},", an assignee email), look them up first. See ",{"type":45,"tag":59,"props":2558,"children":2560},{"className":2559},[],[2561],{"type":50,"value":1665},{"type":50,"value":2563}," for the lookup-then-mutate patterns, including how to close an issue by finding the team's completed workflow state.",{"type":45,"tag":81,"props":2565,"children":2567},{"id":2566},"when-you-need-something-not-covered-here",[2568],{"type":50,"value":2569},"When you need something not covered here",{"type":45,"tag":53,"props":2571,"children":2572},{},[2573],{"type":50,"value":2574},"The Linear schema is large. Instead of guessing field or filter names:",{"type":45,"tag":101,"props":2576,"children":2577},{},[2578,2590],{"type":45,"tag":105,"props":2579,"children":2580},{},[2581,2583,2588],{"type":50,"value":2582},"Open ",{"type":45,"tag":59,"props":2584,"children":2586},{"className":2585},[],[2587],{"type":50,"value":77},{"type":50,"value":2589}," and pick the relevant page.",{"type":45,"tag":105,"props":2591,"children":2592},{},[2593],{"type":50,"value":2594},"Fetch that page (filtering, pagination, SDK fetching and modifying data, or the GraphQL schema reference) and use the exact names from it.",{"type":45,"tag":81,"props":2596,"children":2598},{"id":2597},"gotchas",[2599],{"type":50,"value":2600},"Gotchas",{"type":45,"tag":332,"props":2602,"children":2603},{},[2604,2637,2656,2683],{"type":45,"tag":105,"props":2605,"children":2606},{},[2607,2609,2614,2616,2621,2623,2628,2630,2636],{"type":50,"value":2608},"Run scripts from the working dir (or point at a script inside it) so ",{"type":45,"tag":59,"props":2610,"children":2612},{"className":2611},[],[2613],{"type":50,"value":64},{"type":50,"value":2615}," resolves. ",{"type":45,"tag":59,"props":2617,"children":2619},{"className":2618},[],[2620],{"type":50,"value":512},{"type":50,"value":2622}," does not resolve packages for ESM ",{"type":45,"tag":59,"props":2624,"children":2626},{"className":2625},[],[2627],{"type":50,"value":504},{"type":50,"value":2629},"; it only works for CommonJS ",{"type":45,"tag":59,"props":2631,"children":2633},{"className":2632},[],[2634],{"type":50,"value":2635},"require",{"type":50,"value":563},{"type":45,"tag":105,"props":2638,"children":2639},{},[2640,2642,2648,2649,2655],{"type":50,"value":2641},"Many SDK properties and nested relations are async and return promises or connections. Await them (",{"type":45,"tag":59,"props":2643,"children":2645},{"className":2644},[],[2646],{"type":50,"value":2647},"await issue.state",{"type":50,"value":195},{"type":45,"tag":59,"props":2650,"children":2652},{"className":2651},[],[2653],{"type":50,"value":2654},"await issue.assignee",{"type":50,"value":256},{"type":45,"tag":105,"props":2657,"children":2658},{},[2659,2661,2667,2669,2675,2677,2682],{"type":50,"value":2660},"Connections paginate. Use ",{"type":45,"tag":59,"props":2662,"children":2664},{"className":2663},[],[2665],{"type":50,"value":2666},"connection.pageInfo.hasNextPage",{"type":50,"value":2668}," and ",{"type":45,"tag":59,"props":2670,"children":2672},{"className":2671},[],[2673],{"type":50,"value":2674},"await connection.fetchNext()",{"type":50,"value":2676},", or iterate. See ",{"type":45,"tag":59,"props":2678,"children":2680},{"className":2679},[],[2681],{"type":50,"value":1665},{"type":50,"value":563},{"type":45,"tag":105,"props":2684,"children":2685},{},[2686,2688,2693,2695,2701],{"type":50,"value":2687},"Mutation results expose ",{"type":45,"tag":59,"props":2689,"children":2691},{"className":2690},[],[2692],{"type":50,"value":2130},{"type":50,"value":2694}," and the mutated entity; the entity accessor is usually a promise (",{"type":45,"tag":59,"props":2696,"children":2698},{"className":2697},[],[2699],{"type":50,"value":2700},"await payload.issue",{"type":50,"value":256},{"type":45,"tag":2703,"props":2704,"children":2705},"style",{},[2706],{"type":50,"value":2707},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":2709,"total":2828},[2710,2727,2745,2764,2781,2797,2816],{"slug":2711,"name":2711,"fn":2712,"description":2713,"org":2714,"tags":2715,"stars":28,"repoUrl":29,"updatedAt":2726},"amazon-location-service","integrate Amazon Location Service APIs","Integrates Amazon Location Service APIs for AWS applications. Use this skill when users want to add maps (interactive MapLibre or static images); geocode addresses to coordinates or reverse geocode coordinates to addresses; calculate routes, travel times, or service areas; find places and businesses through text search, nearby search, or autocomplete suggestions; retrieve detailed place information including hours, contacts, and addresses; monitor geographical boundaries with geofences; or track device locations. Covers authentication, SDK integration, and all Amazon Location Service capabilities.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2716,2717,2720,2723],{"name":26,"slug":27,"type":15},{"name":2718,"slug":2719,"type":15},"AWS","aws",{"name":2721,"slug":2722,"type":15},"Maps","maps",{"name":2724,"slug":2725,"type":15},"Navigation","navigation","2026-07-12T08:13:53.294026",{"slug":2728,"name":2728,"fn":2729,"description":2730,"org":2731,"tags":2732,"stars":28,"repoUrl":29,"updatedAt":2744},"amplify-workflow","build full-stack apps with AWS Amplify","Build and deploy full-stack web and mobile apps with AWS Amplify Gen2 (TypeScript code-first). Covers auth (Cognito), data (AppSync\u002FDynamoDB including schema modeling, enum types, relationships, authorization rules), storage (S3), functions, APIs, and AI (Amplify AI Kit with Bedrock). Supports React, Next.js, Vue, Angular, React Native, Flutter, Swift, and Android. Always use this skill for Amplify Gen2 topics — even for questions you think you know — it contains validated, version-specific patterns that prevent common mistakes. TRIGGER when: user mentions Amplify Gen2; project has amplify\u002F directory or amplify_outputs; code imports @aws-amplify packages; user asks about defineBackend, defineAuth, defineData, defineStorage, or npx ampx. SKIP: Amplify Gen1 (amplify CLI v6), standalone SAM\u002FCDK without Amplify (use aws-serverless), direct Bedrock without Amplify AI Kit (use bedrock).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2733,2736,2737,2740,2743],{"name":2734,"slug":2735,"type":15},"Auth","auth",{"name":2718,"slug":2719,"type":15},{"name":2738,"slug":2739,"type":15},"Database","database",{"name":2741,"slug":2742,"type":15},"Frontend","frontend",{"name":23,"slug":24,"type":15},"2026-07-12T08:13:47.134012",{"slug":2746,"name":2746,"fn":2747,"description":2748,"org":2749,"tags":2750,"stars":28,"repoUrl":29,"updatedAt":2763},"analyzer","analyze queried data for trends","Analyze queried data for trends, week-over-week comparisons, distributions, funnels, cohorts, top-N lists, anomalies, sanity checks, and report-ready findings. Use after or alongside ClickHouse queries when the user wants insight rather than raw rows.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2751,2754,2757,2760],{"name":2752,"slug":2753,"type":15},"Analytics","analytics",{"name":2755,"slug":2756,"type":15},"ClickHouse","clickhouse",{"name":2758,"slug":2759,"type":15},"Data Analysis","data-analysis",{"name":2761,"slug":2762,"type":15},"Statistics","statistics","2026-07-12T08:14:05.606036",{"slug":2765,"name":2765,"fn":2766,"description":2767,"org":2768,"tags":2769,"stars":28,"repoUrl":29,"updatedAt":2780},"artifact-management","manage and organize analysis artifacts","Save, organize, and describe reusable analysis artifacts such as SQL, result snapshots, CSV exports, summaries, caveats, plots, and report-ready files. Use when users ask to save, export, share, cite, reproduce, or organize data-analysis outputs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2770,2771,2774,2777],{"name":2758,"slug":2759,"type":15},{"name":2772,"slug":2773,"type":15},"Productivity","productivity",{"name":2775,"slug":2776,"type":15},"Reporting","reporting",{"name":2778,"slug":2779,"type":15},"SQL","sql","2026-07-12T08:14:09.265555",{"slug":2782,"name":2782,"fn":2783,"description":2784,"org":2785,"tags":2786,"stars":28,"repoUrl":29,"updatedAt":2796},"attorney-assist","connect with attorneys for legal consultation","Connects the user with a LegalZoom attorney for legal consultation. Use when a user asks about attorneys, lawyers, or legal help, or when contract review reveals high risks or low-confidence findings.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2787,2790,2793],{"name":2788,"slug":2789,"type":15},"Contracts","contracts",{"name":2791,"slug":2792,"type":15},"Legal","legal",{"name":2794,"slug":2795,"type":15},"Risk Assessment","risk-assessment","2026-07-12T08:13:45.878361",{"slug":2798,"name":2798,"fn":2799,"description":2800,"org":2801,"tags":2802,"stars":28,"repoUrl":29,"updatedAt":2815},"building-pydantic-ai-agents","build AI agents with Pydantic AI","Build AI agents with Pydantic AI — tools, capabilities (including on-demand loading), structured output, streaming, testing, and multi-agent patterns. Use when the user mentions Pydantic AI, imports pydantic_ai, or asks to build an AI agent, add tools\u002Fcapabilities, defer capability loading, stream output, define agents from YAML, or test agent behavior.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2803,2806,2809,2812],{"name":2804,"slug":2805,"type":15},"Agents","agents",{"name":2807,"slug":2808,"type":15},"LLM","llm",{"name":2810,"slug":2811,"type":15},"Multi-Agent","multi-agent",{"name":2813,"slug":2814,"type":15},"Python","python","2026-07-12T08:14:01.893781",{"slug":2756,"name":2756,"fn":2817,"description":2818,"org":2819,"tags":2820,"stars":28,"repoUrl":29,"updatedAt":2827},"query ClickHouse databases via CLI","Connect to and query ClickHouse (a local server or a ClickHouse Cloud service) from the terminal using the official clickhousectl CLI, including the browser OAuth login flow. Use when the user wants to run SQL against ClickHouse, explore schemas and tables, inspect Cloud services, or authenticate clickhousectl. For building a local dev environment or deploying to Cloud, defer to the official ClickHouse skills (see Scope).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2821,2822,2825,2826],{"name":2752,"slug":2753,"type":15},{"name":2823,"slug":2824,"type":15},"CLI","cli",{"name":2755,"slug":2756,"type":15},{"name":2738,"slug":2739,"type":15},"2026-07-12T08:14:06.829692",43,{"items":2830,"total":2956},[2831,2838,2846,2853,2860,2866,2873,2880,2892,2910,2930,2943],{"slug":2711,"name":2711,"fn":2712,"description":2713,"org":2832,"tags":2833,"stars":28,"repoUrl":29,"updatedAt":2726},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2834,2835,2836,2837],{"name":26,"slug":27,"type":15},{"name":2718,"slug":2719,"type":15},{"name":2721,"slug":2722,"type":15},{"name":2724,"slug":2725,"type":15},{"slug":2728,"name":2728,"fn":2729,"description":2730,"org":2839,"tags":2840,"stars":28,"repoUrl":29,"updatedAt":2744},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2841,2842,2843,2844,2845],{"name":2734,"slug":2735,"type":15},{"name":2718,"slug":2719,"type":15},{"name":2738,"slug":2739,"type":15},{"name":2741,"slug":2742,"type":15},{"name":23,"slug":24,"type":15},{"slug":2746,"name":2746,"fn":2747,"description":2748,"org":2847,"tags":2848,"stars":28,"repoUrl":29,"updatedAt":2763},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2849,2850,2851,2852],{"name":2752,"slug":2753,"type":15},{"name":2755,"slug":2756,"type":15},{"name":2758,"slug":2759,"type":15},{"name":2761,"slug":2762,"type":15},{"slug":2765,"name":2765,"fn":2766,"description":2767,"org":2854,"tags":2855,"stars":28,"repoUrl":29,"updatedAt":2780},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2856,2857,2858,2859],{"name":2758,"slug":2759,"type":15},{"name":2772,"slug":2773,"type":15},{"name":2775,"slug":2776,"type":15},{"name":2778,"slug":2779,"type":15},{"slug":2782,"name":2782,"fn":2783,"description":2784,"org":2861,"tags":2862,"stars":28,"repoUrl":29,"updatedAt":2796},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2863,2864,2865],{"name":2788,"slug":2789,"type":15},{"name":2791,"slug":2792,"type":15},{"name":2794,"slug":2795,"type":15},{"slug":2798,"name":2798,"fn":2799,"description":2800,"org":2867,"tags":2868,"stars":28,"repoUrl":29,"updatedAt":2815},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2869,2870,2871,2872],{"name":2804,"slug":2805,"type":15},{"name":2807,"slug":2808,"type":15},{"name":2810,"slug":2811,"type":15},{"name":2813,"slug":2814,"type":15},{"slug":2756,"name":2756,"fn":2817,"description":2818,"org":2874,"tags":2875,"stars":28,"repoUrl":29,"updatedAt":2827},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2876,2877,2878,2879],{"name":2752,"slug":2753,"type":15},{"name":2823,"slug":2824,"type":15},{"name":2755,"slug":2756,"type":15},{"name":2738,"slug":2739,"type":15},{"slug":2881,"name":2881,"fn":2882,"description":2883,"org":2884,"tags":2885,"stars":28,"repoUrl":29,"updatedAt":2891},"cline-session-history","search and browse Cline session history","Search and browse Cline session history. Use when the user asks to find, list, inspect, or export Cline sessions by time period, prompt content, status, model, provider, source, mode, workspace, or other criteria. Also use when the user wants to read a session transcript or export sessions to a directory. Trigger phrases include \"find my session\", \"search my session history\", \"show me past sessions\", \"what was that session where\", \"find the session that started with\", and any mention of past Cline conversations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2886,2887,2890],{"name":2804,"slug":2805,"type":15},{"name":2888,"slug":2889,"type":15},"History","history",{"name":2772,"slug":2773,"type":15},"2026-07-19T06:03:13.945151",{"slug":2893,"name":2893,"fn":2894,"description":2895,"org":2896,"tags":2897,"stars":28,"repoUrl":29,"updatedAt":2909},"convex-design","build reactive backends with Convex","Design and build reactive, type-safe, production-grade backends on Convex. Covers schema, queries\u002Fmutations\u002Factions, indexes, auth, file storage, scheduling, real-time multiplayer, mobile backends, and LLM\u002Fagent workflows on Convex's one-platform stack.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2898,2899,2902,2903,2906],{"name":2734,"slug":2735,"type":15},{"name":2900,"slug":2901,"type":15},"Backend","backend",{"name":2738,"slug":2739,"type":15},{"name":2904,"slug":2905,"type":15},"Real-time","real-time",{"name":2907,"slug":2908,"type":15},"Storage","storage","2026-07-12T08:13:37.101253",{"slug":2911,"name":2911,"fn":2912,"description":2913,"org":2914,"tags":2915,"stars":28,"repoUrl":29,"updatedAt":2929},"cosmosdb-best-practices","optimize Azure Cosmos DB performance","Azure Cosmos DB performance optimization and best practices guidelines for NoSQL,\npartitioning, queries, SDK usage, and vector search. Use when writing, reviewing,\nor refactoring code that interacts with Azure Cosmos DB, designing data models,\noptimizing queries, or implementing high-performance database operations.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2916,2919,2922,2923,2926],{"name":2917,"slug":2918,"type":15},"Azure","azure",{"name":2920,"slug":2921,"type":15},"Cosmos DB","cosmos-db",{"name":2738,"slug":2739,"type":15},{"name":2924,"slug":2925,"type":15},"NoSQL","nosql",{"name":2927,"slug":2928,"type":15},"Performance","performance","2026-07-12T08:13:54.531719",{"slug":2931,"name":2931,"fn":2932,"description":2933,"org":2934,"tags":2935,"stars":28,"repoUrl":29,"updatedAt":2942},"data-analyst","analyze ClickHouse analytics data","Act as an interactive data analyst for ClickHouse-backed analytics. Use when the user asks questions about internal data, metrics, dashboards, telemetry, active users, revenue, funnels, trends, distributions, or wants an analyst-style conversation, ad hoc SQL, charts, or a data export against ClickHouse (local or ClickHouse Cloud).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2936,2937,2938,2941],{"name":2752,"slug":2753,"type":15},{"name":2755,"slug":2756,"type":15},{"name":2939,"slug":2940,"type":15},"Dashboards","dashboards",{"name":2758,"slug":2759,"type":15},"2026-07-12T08:13:31.975246",{"slug":2944,"name":2944,"fn":2945,"description":2946,"org":2947,"tags":2948,"stars":28,"repoUrl":29,"updatedAt":2955},"dataproc-skills","manage Dataproc clusters and jobs","Skills to interact with your Dataproc clusters and jobs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2949,2952],{"name":2950,"slug":2951,"type":15},"Data Engineering","data-engineering",{"name":2953,"slug":2954,"type":15},"Operations","operations","2026-07-12T08:13:42.179275",45]