client-handover 1.3.0 → 1.4.1

package/README.md

@@ -6,183 +6,87 @@
 
 AI-powered handover document generator for frontend developers handing off websites to clients.
 
-Run one command. Get a professional handover document in Markdown, plain text, and HTML — written for both your client and the next developer.
+Run one command from inside your project. Get professional handover documents in Markdown, plain text, and Word — written for both your client and the next developer.
 
-Uses the [Claude API](https://console.anthropic.com) (Anthropic) under the hood.
+Powered by [Claude Code](https://claude.ai) — no API key or credits required.
 
 ---
 
-## Install
+## Requirements
 
-```bash
-npm install -g client-handover
-```
+- Node.js 18+
+- [Claude Code](https://claude.ai/download) installed and logged in (`claude login`)
 
-### API key setup
+Claude Code is free with a Claude Pro subscription.
 
-**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:
+## Install
 
 ```bash
-# macOS / Linux
-export ANTHROPIC_API_KEY=your_key_here
-
-# Windows (Command Prompt)
-set ANTHROPIC_API_KEY=your_key_here
-
-# Windows (PowerShell)
-$env:ANTHROPIC_API_KEY="your_key_here"
+npm install -g client-handover
 ```
 
-Get a free API key at [console.anthropic.com](https://console.anthropic.com)
-
 ---
 
 ## Quick start
 
 ```bash
-handover handover
+cd my-client-project
+handover /create
 ```
 
-This generates a full handover document with placeholder content in an `output/` folder in your current directory.
-
----
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `all` | Every section as separate files in one folder |
-| `handover` | Full handover document (all sections combined) |
-| `setup` | Project setup & dependencies |
-| `deploy` | Deployment & hosting info |
-| `credentials` | Logins & API keys template |
-| `license` | Licensing & attribution |
+On first run you'll be asked for your name, company, email, and phone — these appear in every document you generate.
 
 ---
 
 ## Usage
 
-### With your own project notes
-
-Create a plain text file describing your project:
-
-```
-project-info.txt
-----------------
-Project: Acme Corp website
-Stack: Vue 3, Vite, Netlify
-Repo: https://github.com/you/acme
-Live URL: https://acmecorp.com
-Hosting: Netlify (free tier)
-Domain: Namecheap, auto-renews Jan 2026
-CMS: Netlify CMS
-Analytics: Google Analytics 4
-APIs: Mailchimp (newsletter), Stripe (payments)
-```
-
-Then run any command with that file as input:
-
 ```bash
-# Every section as separate files in one folder
-handover all project-info.txt acme-client
-
-# Full combined doc
-handover handover project-info.txt
-
-# Full combined doc with a custom output filename
-handover handover project-info.txt acme-handover
-
-# Individual sections
-handover setup project-info.txt
-handover deploy project-info.txt
-handover credentials project-info.txt
-handover license project-info.txt
+handover /create
 ```
 
-The more detail you put in your project-info file, the more accurate and useful the output will be.
+Choose from:
+- `1` — Technical handover (for the next developer)
+- `2` — Client handover (plain English, for your client)
+- `3` — Both
+
+The tool scans your project automatically — no config file needed.
 
 ---
 
 ## Output
 
-All commands generate three files per section inside an `output/` folder.
+Documents are saved in your project folder:
 
-**Single command** (e.g. `handover`):
-```
-output/
-├── handover.md      ← Paste into Notion, GitHub, or a README
-├── handover.txt     ← Clean plain text for email or printing
-└── handover.html    ← Styled HTML ready to send directly to a client
 ```
+technical-handover/
+├── technical-handover.md
+├── technical-handover.txt
+└── technical-handover.docx
 
-**`all` command** — every section in its own subfolder:
-```
-output/acme-client/
-├── handover.md / .txt / .html
-├── setup.md / .txt / .html
-├── deploy.md / .txt / .html
-├── credentials.md / .txt / .html
-└── license.md / .txt / .html
+client-handover/
+├── client-handover.md
+├── client-handover.txt
+└── client-handover.docx
 ```
 
 | Format | Best for |
 |--------|----------|
 | `.md`  | Notion, GitHub, linear docs |
 | `.txt` | Email attachments, printing |
-| `.html`| Sending directly to a client |
-
----
-
-## Use as a library
-
-You can also import the prompt builders and doc generator directly into your own project:
-
-```js
-import { handover, setup, generateDoc } from 'client-handover'
-
-// Build a prompt from your project info string
-const prompt = handover('Vue 3 project hosted on Vercel, domain on Cloudflare...')
-
-// Generate and save the document
-await generateDoc(prompt, 'my-client', './docs')
-```
-
-### Available exports
-
-| Export | Type | Description |
-|--------|------|-------------|
-| `generateDoc(prompt, name, dir)` | async function | Calls Claude API and writes `.md`, `.txt`, `.html` |
-| `handover(projectInfo)` | function | Prompt builder for full handover doc |
-| `setup(projectInfo)` | function | Prompt builder for setup section |
-| `deploy(projectInfo)` | function | Prompt builder for deployment section |
-| `credentials(projectInfo)` | function | Prompt builder for credentials section |
-| `license(projectInfo)` | function | Prompt builder for licensing section |
-
-All prompt builders accept an optional `projectInfo` string. If omitted, Claude generates placeholder content.
-
----
-
-## Requirements
-
-- Node.js 18+
-- 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)
+| `.docx`| Sending directly to a client |
 
 ---
 
 ## How it works
 
-1. You provide a plain text description of your project (or nothing, for placeholder output)
-2. The CLI builds a structured prompt for Claude
-3. Claude generates a professional, dual-audience document (plain English for clients, technical detail for developers)
-4. The output is saved as `.md`, `.txt`, and `.html`
-
-Each document section is written for **two audiences**:
-- **The client** — plain English, reassuring tone, no jargon
-- **The next developer** — precise technical detail, commands, file paths
+1. The tool scans your project — `package.json`, config files, env variable keys, deploy configs, folder structure, CSS colours
+2. It builds a structured prompt and sends it to Claude via Claude Code
+3. Claude generates a professional document written for two audiences:
+   - **The client** — plain English, reassuring tone, no jargon
+   - **The next developer** — precise technical detail, commands, file paths
+4. Output is saved as `.md`, `.txt`, and `.docx`
 
 ---
 
@@ -190,28 +94,31 @@ Each document section is written for **two audiences**:
 
 ```
 client-handover/
-├── cli.js           # CLI entry point
-├── index.js         # Library exports
-├── generator.js     # Claude API call + file output
-├── handover.js      # Full handover prompt builder
-├── setup.js         # Setup section prompt builder
-├── deploy.js        # Deployment section prompt builder
-├── credentials.js   # Credentials section prompt builder
-└── license.js       # Licensing section prompt builder
+├── cli.js        # CLI entry point
+├── generator.js  # Claude Code SDK call + file output
+├── prompts.js    # Prompt builders
+└── scanner.js    # Project file scanner
 ```
 
 ---
 
 ## Changelog
 
+### 1.4.0
+- Switched from Anthropic API to Claude Code SDK — no API key or credits required
+- Removed `handover key` command and API key setup prompt
+- Claude Code is now installed automatically as a dependency
+
+### 1.3.0
+- Improved setup flow and document type selection
+
 ### 1.0.0
 - Initial release
 - Single command: `handover /create`
 - Generates two documents per run — technical handover (for developers) and client handover (plain English)
 - Auto-scans project files: package.json, config files, env variable keys, deploy configs, folder structure, CSS colours
-- First-run setup prompts for API key, name, company, email, and phone
+- First-run setup prompts for name, company, email, and phone
 - Outputs `.md`, `.txt`, and `.docx` formats
-- Auto-detects Claude Code credentials — no API key setup needed if you have Claude Code installed
 
 ---
 

package/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { generateDoc, resolveApiKey, saveApiKey } from './generator.js'
+import { generateDoc } from './generator.js'
 import { technicalHandoverPrompt, nonTechnicalHandoverPrompt } from './prompts.js'
 import { scanProject } from './scanner.js'
 import chalk from 'chalk'
@@ -31,8 +31,7 @@ function printBanner() {
 function printHelp() {
   printBanner()
   console.log(chalk.dim('  Usage:'))
-  console.log('    handover /create       Generate technical & non-technical handover documents')
-  console.log('    handover key <key>     Save your Anthropic API key\n')
+  console.log('    handover /create       Generate technical & non-technical handover documents\n')
   console.log(chalk.dim('  Example:'))
   console.log('    cd my-client-project')
   console.log('    handover /create\n')
@@ -52,10 +51,9 @@ async function runSetup() {
     if (fs.existsSync(configPath)) config = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
   } catch {}
 
-  const hasApiKey = !!resolveApiKey(config)
   const hasDeveloperInfo = !!config.developerName
 
-  if (hasApiKey && hasDeveloperInfo) {
+  if (hasDeveloperInfo) {
     return {
       name: config.developerName,
       company: config.developerCompany || '',
@@ -70,18 +68,6 @@ async function runSetup() {
 
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
 
-  if (!hasApiKey) {
-    console.log(' To generate documents you need an Anthropic API key.')
-    console.log(chalk.dim(' Get one free at: https://console.anthropic.com\n'))
-    let key = ''
-    while (!key) {
-      key = await ask(rl, ' Enter your Anthropic API key: ')
-      if (!key) console.log(chalk.yellow(' API key is required to continue.\n'))
-    }
-    config.apiKey = key
-    console.log(chalk.green(' ✓ API key saved.\n'))
-  }
-
   if (!hasDeveloperInfo) {
     console.log(' Your details will appear in all generated handover documents.\n')
     const name = await ask(rl, ' Developer name: ')
@@ -171,16 +157,6 @@ async function main() {
 
   const command = normalizeCommand(rawCommand)
 
-  if (command === 'key') {
-    if (!secondArg) {
-      console.error(chalk.red('\n ❌ Usage: handover key <your-api-key>\n'))
-      process.exit(1)
-    }
-    saveApiKey(secondArg)
-    console.log(chalk.green('\n ✅ API key saved. Run "handover /create" to get started.\n'))
-    process.exit(0)
-  }
-
   if (command !== 'create') {
     console.error(chalk.red(`\n ❌ Unknown command: ${rawCommand}\n`))
     printHelp()
@@ -190,11 +166,7 @@ async function main() {
   try {
     await runCreate()
   } catch (err) {
-    if (err.status === 401) {
-      console.error(chalk.red('\n ❌ Authentication failed. Run "handover key <your-api-key>" to set your API key.\n'))
-    } else {
-      console.error(chalk.red(`\n ❌ Error: ${err.message}\n`))
-    }
+    console.error(chalk.red(`\n ❌ Error: ${err.message}\n`))
     process.exit(1)
   }
 }

package/generator.js

@@ -1,4 +1,4 @@
-import Anthropic from '@anthropic-ai/sdk'
+import { query } from '@anthropic-ai/claude-code'
 import {
   Document, Packer, Paragraph, TextRun, HeadingLevel,
   AlignmentType, BorderStyle, TableRow, TableCell, Table,
@@ -6,51 +6,6 @@ import {
 } from 'docx'
 import fs from 'fs'
 import path from 'path'
-import os from 'os'
-
-export function resolveApiKey(config = null) {
-  if (process.env.ANTHROPIC_API_KEY) return process.env.ANTHROPIC_API_KEY
-
-  const cfg = config || (() => {
-    try {
-      const p = path.join(os.homedir(), '.handover', 'config.json')
-      if (fs.existsSync(p)) return JSON.parse(fs.readFileSync(p, 'utf-8'))
-    } catch {}
-    return {}
-  })()
-
-  if (cfg?.apiKey) return cfg.apiKey
-
-  const credentialsPath = path.join(os.homedir(), '.claude', '.credentials.json')
-  try {
-    if (fs.existsSync(credentialsPath)) {
-      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 {}
-
-  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 })
-  let config = {}
-  try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')) } catch {}
-  config.apiKey = key
-  fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8')
-}
-
-const apiKey = resolveApiKey()
-if (!apiKey) {
-  console.error('\n ❌ No API key found. Run "handover key <your-api-key>" or install Claude Code.\n')
-  process.exit(1)
-}
-
-const client = new Anthropic({ apiKey })
 
 // ---------------------------------------------------------------------------
 // Inline text parser — splits a line into TextRun segments handling **bold**,
@@ -298,13 +253,14 @@ function buildDocx(markdown) {
 export async function generateDoc(prompt, outputName = 'handover', outputDir = './output') {
   console.log('⏳ Generating document with Claude...\n')
 
-  const message = await client.messages.create({
-    model: 'claude-sonnet-4-20250514',
-    max_tokens: 4096,
-    messages: [{ role: 'user', content: prompt }]
-  })
+  let markdown = ''
+  for await (const message of query({ prompt, options: { maxTurns: 1 } })) {
+    if (message.type === 'result' && message.subtype === 'success') {
+      markdown = message.result
+    }
+  }
 
-  const markdown = message.content[0].text
+  if (!markdown) throw new Error('No response received from Claude')
 
   if (!fs.existsSync(outputDir)) {
     fs.mkdirSync(outputDir, { recursive: true })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "client-handover",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "AI-powered handover document generator for frontend developers handing off client websites",
   "type": "module",
   "bin": {
@@ -29,7 +29,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.39.0",
+    "@anthropic-ai/claude-code": "*",
     "chalk": "^5.3.0",
     "docx": "^8.5.0"
   }