client-handover 1.0.3 → 1.0.5

package/README.md

@@ -14,7 +14,11 @@ Uses the [Claude API](https://console.anthropic.com) (Anthropic) under the hood.
 npm install -g client-handover
 ```
 
-Then set your Anthropic API key as an environment variable:
+### API key setup
+
+**If you have Claude Code installed**, no setup needed — `client-handover` will automatically use your existing Claude credentials.
+
+**Otherwise**, set your Anthropic API key as an environment variable:
 
 ```bash
 # macOS / Linux
@@ -159,7 +163,9 @@ All prompt builders accept an optional `projectInfo` string. If omitted, Claude
 ## Requirements
 
 - Node.js 18+
-- An Anthropic API key — [get one free at console.anthropic.com](https://console.anthropic.com)
+- One of the following:
+  - [Claude Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) installed (zero config — credentials detected automatically)
+  - Or an Anthropic API key — [get one free at console.anthropic.com](https://console.anthropic.com)
 
 ---
 
@@ -192,6 +198,27 @@ client-handover/
 
 ---
 
+## Changelog
+
+### 1.0.5
+- Interactive API key setup prompt on install — no manual config needed
+- Added `handover key <api-key>` command to save key at any time
+- Key is stored in `~/.handover/config.json` and persists across all sessions
+
+### 1.0.4
+- Auto-detects Claude Code credentials — no API key setup needed if you have Claude Code installed
+
+### 1.0.3
+- Commands now work with or without a leading `/` — fixes Git Bash path conversion issues on Windows
+
+### 1.0.2
+- Added `all` command — generates every section as separate files in a single named folder
+
+### 1.0.1
+- Initial release
+
+---
+
 ## Contributing
 
 Pull requests are welcome. For major changes, open an issue first.

package/cli.js

@@ -5,7 +5,7 @@ import { deploy } from './deploy.js'
 import { credentials } from './credentials.js'
 import { handover } from './handover.js'
 import { license } from './license.js'
-import { generateDoc } from './generator.js'
+import { generateDoc, saveApiKey } from './generator.js'
 import chalk from 'chalk'
 import fs from 'fs'
 import path from 'path'
@@ -33,6 +33,7 @@ function printHelp() {
     console.log(`  ${chalk.cyan(cmd.padEnd(16))} ${label}`)
   })
   console.log(`  ${chalk.cyan('all'.padEnd(16))} All sections in a single folder`)
+  console.log(`  ${chalk.cyan('key <api-key>'.padEnd(16))} Save your Anthropic API key (one-time setup)`)
   console.log('\n' + chalk.dim('Examples:'))
   console.log('  handover handover                               # Full doc with placeholders')
   console.log('  handover setup project-info.txt                # Setup section using your notes')
@@ -74,6 +75,17 @@ async function main() {
 
   const command = normalizeCommand(rawCommand)
 
+  if (command === 'key') {
+    const key = infoFile // second arg is the key
+    if (!key) {
+      console.error(chalk.red('\n❌ Usage: handover key <your-api-key>\n'))
+      process.exit(1)
+    }
+    saveApiKey(key)
+    console.log(chalk.green('\n✅ API key saved. You\'re all set — run any handover command.\n'))
+    process.exit(0)
+  }
+
   // Read optional project info file
   let projectInfo = ''
   if (infoFile) {
@@ -91,7 +103,7 @@ async function main() {
       await runAll(projectInfo, folderName)
     } catch (err) {
       if (err.status === 401) {
-        console.error(chalk.red('\n❌ Invalid API key. Set your ANTHROPIC_API_KEY environment variable.\n'))
+        console.error(chalk.red('\n❌ Authentication failed. Set ANTHROPIC_API_KEY or install Claude Code.\n'))
       } else {
         console.error(chalk.red(`\n❌ Error: ${err.message}\n`))
       }
@@ -117,7 +129,7 @@ async function main() {
     await generateDoc(prompt, docName, './output')
   } catch (err) {
     if (err.status === 401) {
-      console.error(chalk.red('\n❌ Invalid API key. Set your ANTHROPIC_API_KEY environment variable.\n'))
+      console.error(chalk.red('\n❌ Authentication failed. Set ANTHROPIC_API_KEY or install Claude Code.\n'))
     } else {
       console.error(chalk.red(`\n❌ Error: ${err.message}\n`))
     }

package/generator.js

@@ -2,8 +2,53 @@ import Anthropic from '@anthropic-ai/sdk'
 import { marked } from 'marked'
 import fs from 'fs'
 import path from 'path'
+import os from 'os'
 
-const client = new Anthropic()
+function resolveApiKey() {
+  if (process.env.ANTHROPIC_API_KEY) return process.env.ANTHROPIC_API_KEY
+
+  // Check saved key from `handover key <your-key>`
+  const configPath = path.join(os.homedir(), '.handover', 'config.json')
+  if (fs.existsSync(configPath)) {
+    try {
+      const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
+      if (config?.apiKey) return config.apiKey
+    } catch {
+      // ignore malformed config file
+    }
+  }
+
+  const credentialsPath = path.join(os.homedir(), '.claude', '.credentials.json')
+  if (fs.existsSync(credentialsPath)) {
+    try {
+      const creds = JSON.parse(fs.readFileSync(credentialsPath, 'utf-8'))
+      const token = creds?.claudeAiOauth?.accessToken
+      const expiresAt = creds?.claudeAiOauth?.expiresAt
+      if (token && (!expiresAt || expiresAt > Date.now())) {
+        return token
+      }
+    } catch {
+      // ignore malformed credentials file
+    }
+  }
+
+  return null
+}
+
+export function saveApiKey(key) {
+  const configDir = path.join(os.homedir(), '.handover')
+  const configPath = path.join(configDir, 'config.json')
+  if (!fs.existsSync(configDir)) fs.mkdirSync(configDir, { recursive: true })
+  fs.writeFileSync(configPath, JSON.stringify({ apiKey: key }, null, 2), 'utf-8')
+}
+
+const apiKey = resolveApiKey()
+if (!apiKey) {
+  console.error('\n❌ No API key found. Set ANTHROPIC_API_KEY or install Claude Code (code.visualstudio.com/download).\n')
+  process.exit(1)
+}
+
+const client = new Anthropic({ apiKey })
 
 /**
  * Generate a handover document using the Claude API

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "client-handover",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "AI-powered handover document generator for frontend developers handing off client websites",
   "type": "module",
   "main": "index.js",
@@ -16,10 +16,12 @@
     "deploy.js",
     "credentials.js",
     "license.js",
+    "postinstall.js",
     "README.md"
   ],
   "scripts": {
-    "test": "node test.js"
+    "test": "node test.js",
+    "postinstall": "node postinstall.js"
   },
   "keywords": [
     "handover",

package/postinstall.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+
+import readline from 'readline'
+import fs from 'fs'
+import path from 'path'
+import os from 'os'
+
+const configDir = path.join(os.homedir(), '.handover')
+const configPath = path.join(configDir, 'config.json')
+const claudeCredsPath = path.join(os.homedir(), '.claude', '.credentials.json')
+
+function alreadyConfigured() {
+  if (process.env.ANTHROPIC_API_KEY) return true
+
+  if (fs.existsSync(configPath)) {
+    try {
+      const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
+      if (config?.apiKey) return true
+    } catch {}
+  }
+
+  if (fs.existsSync(claudeCredsPath)) {
+    try {
+      const creds = JSON.parse(fs.readFileSync(claudeCredsPath, 'utf-8'))
+      const token = creds?.claudeAiOauth?.accessToken
+      const expiresAt = creds?.claudeAiOauth?.expiresAt
+      if (token && (!expiresAt || expiresAt > Date.now())) return true
+    } catch {}
+  }
+
+  return false
+}
+
+function saveKey(key) {
+  if (!fs.existsSync(configDir)) fs.mkdirSync(configDir, { recursive: true })
+  fs.writeFileSync(configPath, JSON.stringify({ apiKey: key }, null, 2), 'utf-8')
+}
+
+// Skip if already set up or not in an interactive terminal
+if (alreadyConfigured() || !process.stdin.isTTY) {
+  process.exit(0)
+}
+
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+
+console.log('\n──────────────────────────────────────────')
+console.log(' client-handover setup')
+console.log('──────────────────────────────────────────')
+console.log(' To generate documents, you need an Anthropic API key.')
+console.log(' Get one free at: https://console.anthropic.com\n')
+
+rl.question(' Enter your Anthropic API key (or press Enter to skip): ', (answer) => {
+  rl.close()
+  const key = answer.trim()
+
+  if (!key) {
+    console.log('\n Skipped. Run "handover key <your-api-key>" at any time to set it.\n')
+    process.exit(0)
+  }
+
+  saveKey(key)
+  console.log('\n✅ API key saved. Run "handover handover" to get started.\n')
+  process.exit(0)
+})