client-handover 1.0.4 → 1.0.5

package/README.md

@@ -163,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)
 
 ---
 
@@ -196,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) {

package/generator.js

@@ -7,6 +7,17 @@ import os from 'os'
 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 {
@@ -24,6 +35,13 @@ function resolveApiKey() {
   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')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "client-handover",
-  "version": "1.0.4",
+  "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)
+})