linear-cli-agents 0.4.1 → 0.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linear-cli-agents",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "CLI for interacting with Linear, designed for LLMs and agents",
   "author": "Nacho",
   "bin": {
@@ -20,6 +20,7 @@
   "files": [
     "/bin",
     "/dist",
+    "/scripts",
     "/oclif.manifest.json"
   ],
   "dependencies": {
@@ -60,6 +61,9 @@
       "comments": {
         "description": "Comment management commands"
       },
+      "config": {
+        "description": "Configuration management commands"
+      },
       "issues": {
         "description": "Issue management commands"
       },
@@ -92,18 +96,6 @@
       }
     }
   },
-  "scripts": {
-    "build": "shx rm -rf dist && tsc -b",
-    "lint": "eslint . && tsc --noEmit",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "postpack": "shx rm -f oclif.manifest.json",
-    "prepack": "pnpm run build && oclif manifest && oclif readme",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
-  },
   "engines": {
     "node": ">=18.0.0"
   },
@@ -114,6 +106,16 @@
     "agent",
     "project-management"
   ],
-  "packageManager": "pnpm@10.18.1",
-  "prettier": "@oclif/prettier-config"
-}
+  "prettier": "@oclif/prettier-config",
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js || true",
+    "build": "shx rm -rf dist && tsc -b",
+    "lint": "eslint . && tsc --noEmit",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script that optionally adds Linear CLI usage instructions to CLAUDE.md
+ */
+
+import {existsSync, readFileSync, writeFileSync, mkdirSync} from 'node:fs'
+import {homedir} from 'node:os'
+import {join, dirname} from 'node:path'
+import {createInterface} from 'node:readline'
+
+const CLAUDE_MD_PATH = join(homedir(), '.claude', 'CLAUDE.md')
+const LINEAR_CLI_SECTION_START = '<!-- LINEAR-CLI-START -->'
+const LINEAR_CLI_SECTION_END = '<!-- LINEAR-CLI-END -->'
+
+const LINEAR_CLI_DOCS = `${LINEAR_CLI_SECTION_START}
+## Linear CLI
+
+CLI for Linear. Run \`linear info\` for full documentation.
+
+\`\`\`bash
+linear auth login                          # Authenticate (one-time)
+linear info                                # Get all commands and docs
+linear issues create --title "X" --team-id ID
+linear issues bulk-update --ids A,B,C --state-id ID
+\`\`\`
+${LINEAR_CLI_SECTION_END}`
+
+const updateClaudeMd = () => {
+  const dir = dirname(CLAUDE_MD_PATH)
+  if (!existsSync(dir)) {
+    mkdirSync(dir, {recursive: true})
+  }
+
+  let content = existsSync(CLAUDE_MD_PATH) ? readFileSync(CLAUDE_MD_PATH, 'utf-8') : ''
+
+  if (content.includes(LINEAR_CLI_SECTION_START)) {
+    const regex = new RegExp(`${LINEAR_CLI_SECTION_START}[\\s\\S]*?${LINEAR_CLI_SECTION_END}`, 'g')
+    content = content.replace(regex, LINEAR_CLI_DOCS)
+  } else {
+    const separator = content.length > 0 && !content.endsWith('\n\n') ? '\n\n' : ''
+    content = content + separator + LINEAR_CLI_DOCS + '\n'
+  }
+
+  writeFileSync(CLAUDE_MD_PATH, content, 'utf-8')
+  return true
+}
+
+const askQuestion = (question) => {
+  return new Promise((resolve) => {
+    // Check if stdin is available and interactive
+    if (!process.stdin.isTTY) {
+      resolve(null)
+      return
+    }
+
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    })
+
+    rl.question(question, (answer) => {
+      rl.close()
+      resolve(answer?.toLowerCase().trim())
+    })
+
+    // Timeout after 10 seconds
+    setTimeout(() => {
+      rl.close()
+      resolve(null)
+    }, 10000)
+  })
+}
+
+const main = async () => {
+  // Skip in CI environments
+  if (process.env.CI || process.env.GITHUB_ACTIONS) {
+    return
+  }
+
+  console.log('\n✓ Linear CLI installed')
+
+  const answer = await askQuestion('  Add usage instructions to ~/.claude/CLAUDE.md? [y/N] ')
+
+  if (answer === 'y' || answer === 'yes') {
+    try {
+      updateClaudeMd()
+      console.log('  ✓ Added to CLAUDE.md\n')
+    } catch {
+      console.log('  ✗ Failed. Run "linear setup" manually.\n')
+    }
+  } else {
+    console.log('  Run "linear setup" later to add instructions.\n')
+  }
+}
+
+main()