@damper/cli 0.1.2 → 0.1.4

package/README.md

@@ -17,8 +17,12 @@ Claude then handles the task lifecycle via Damper MCP - logging commits, adding
 # Run directly with npx (recommended)
 npx @damper/cli
 
+# Alternative: use the 'damper' command name
+npx damper
+
 # Or install globally
 npm install -g @damper/cli
+damper
 ```
 
 ### Prerequisites
@@ -59,6 +63,11 @@ Configure Damper MCP in Claude Code. Run this first if you haven't set up MCP ye
 - Configures `~/.claude/settings.json` with Damper MCP
 - Prompts for API key if not in environment
 
+```bash
+npx @damper/cli setup                # First-time setup
+npx @damper/cli setup --reconfigure  # Change API key
+```
+
 ### `npx @damper/cli status`
 
 Show all tracked worktrees and their task status.
@@ -148,6 +157,33 @@ Once Claude is running, it handles:
 | `DAMPER_API_KEY` | Your Damper API key (or configure via `setup`) |
 | `DAMPER_API_URL` | API URL override (default: `https://api.usedamper.com`) |
 
+### Per-Project API Keys
+
+Damper API keys are project-scoped. If you work with multiple Damper projects, you can use different keys:
+
+**Option 1: Environment variable (recommended)**
+```bash
+# Set in your shell or project's .env file
+export DAMPER_API_KEY=your-project-specific-key
+npx @damper/cli
+```
+
+**Option 2: Use direnv for automatic switching**
+```bash
+# In each project directory, create .envrc:
+echo 'export DAMPER_API_KEY=your-key-here' > .envrc
+direnv allow
+```
+
+**Option 3: Reconfigure when switching projects**
+```bash
+npx @damper/cli setup --reconfigure
+```
+
+The CLI checks for keys in this order:
+1. `DAMPER_API_KEY` environment variable
+2. `~/.claude/settings.json` (configured via `setup`)
+
 ## How it Works
 
 ### Worktree Isolation

package/dist/commands/setup.d.ts

@@ -1 +1,4 @@
-export declare function setupCommand(): Promise<void>;
+export interface SetupOptions {
+    reconfigure?: boolean;
+}
+export declare function setupCommand(options?: SetupOptions): Promise<void>;

package/dist/commands/setup.js

@@ -1,7 +1,26 @@
+import { confirm } from '@inquirer/prompts';
 import pc from 'picocolors';
-import { isDamperMcpConfigured, getConfiguredApiKey, setupDamperMcp, isClaudeInstalled, } from '../services/claude.js';
+import { isDamperMcpConfigured, getConfiguredApiKey, setupDamperMcp, configureDamperMcp, isClaudeInstalled, } from '../services/claude.js';
 import { createDamperApi } from '../services/damper-api.js';
-export async function setupCommand() {
+async function promptForNewApiKey() {
+    const { password } = await import('@inquirer/prompts');
+    console.log(pc.dim('\nGet your API key from: https://usedamper.com → Settings → API Keys\n'));
+    const apiKey = await password({
+        message: 'Enter your new Damper API key:',
+        mask: '*',
+        validate: (value) => {
+            if (!value || value.trim().length === 0) {
+                return 'API key is required';
+            }
+            if (value.length < 10) {
+                return 'API key seems too short';
+            }
+            return true;
+        },
+    });
+    return apiKey.trim();
+}
+export async function setupCommand(options = {}) {
     console.log(pc.bold('\n@damper/cli Setup\n'));
     // Check Claude CLI
     const claudeInstalled = await isClaudeInstalled();
@@ -18,6 +37,30 @@ export async function setupCommand() {
     if (mcpConfigured && apiKey) {
         console.log(pc.green('✓ Damper MCP configured'));
         console.log(pc.dim(`  API key: ${'*'.repeat(12)} (${apiKey.length} chars)`));
+        // If reconfigure flag is set, prompt for new key
+        if (options.reconfigure) {
+            console.log(pc.yellow('\nReconfiguring API key...'));
+            const newKey = await promptForNewApiKey();
+            if (newKey) {
+                // Verify before saving
+                console.log(pc.dim('\nVerifying new API key...'));
+                try {
+                    const api = createDamperApi(newKey);
+                    const { project } = await api.listTasks({ limit: 1 });
+                    console.log(pc.green(`✓ Connected to project: ${project}`));
+                    // Save the new key
+                    configureDamperMcp(newKey);
+                    process.env.DAMPER_API_KEY = newKey;
+                    console.log(pc.green('\n✓ API key updated successfully!\n'));
+                }
+                catch (err) {
+                    const error = err;
+                    console.log(pc.red(`✗ API key verification failed: ${error.message}`));
+                    console.log(pc.dim('  API key was NOT updated.\n'));
+                }
+            }
+            return;
+        }
         // Verify the API key works
         console.log(pc.dim('\nVerifying API key...'));
         try {
@@ -28,16 +71,24 @@ export async function setupCommand() {
         catch (err) {
             const error = err;
             console.log(pc.red(`✗ API key verification failed: ${error.message}`));
-            console.log(pc.dim('  You may need to reconfigure with a valid key.\n'));
             // Offer to reconfigure
-            const key = await setupDamperMcp();
-            if (key) {
-                console.log(pc.green('\n✓ Setup complete!\n'));
+            const shouldReconfigure = await confirm({
+                message: 'Would you like to enter a new API key?',
+                default: true,
+            });
+            if (shouldReconfigure) {
+                const newKey = await promptForNewApiKey();
+                if (newKey) {
+                    configureDamperMcp(newKey);
+                    process.env.DAMPER_API_KEY = newKey;
+                    console.log(pc.green('\n✓ API key updated!\n'));
+                }
             }
             return;
         }
         console.log(pc.green('\n✓ All checks passed! You\'re ready to use @damper/cli.\n'));
-        console.log(pc.dim('Run `npx @damper/cli` to start working on a task.\n'));
+        console.log(pc.dim('Run `npx @damper/cli` to start working on a task.'));
+        console.log(pc.dim('Run `npx @damper/cli setup --reconfigure` to change API key.\n'));
         return;
     }
     // Not configured - run setup

package/dist/index.js

@@ -4,7 +4,7 @@ import { startCommand } from './commands/start.js';
 import { statusCommand } from './commands/status.js';
 import { cleanupCommand } from './commands/cleanup.js';
 import { setupCommand } from './commands/setup.js';
-const VERSION = '0.1.0';
+const VERSION = '0.1.4';
 function showHelp() {
     console.log(`
 ${pc.bold('@damper/cli')} - Agent orchestration for Damper tasks
@@ -19,6 +19,7 @@ ${pc.bold('Options:')}
   --task <id>                        Work on a specific task
   --type <type>                      Filter by type: bug, feature, improvement, task
   --status <status>                  Filter by status: planned, in_progress, done, all
+  --reconfigure                      Change API key (use with setup command)
   -h, --help                         Show this help message
   -v, --version                      Show version
 
@@ -49,6 +50,7 @@ function showVersion() {
 function parseArgs(args) {
     const result = {
         options: {},
+        setupOptions: {},
         help: false,
         version: false,
     };
@@ -75,6 +77,9 @@ function parseArgs(args) {
                 result.options.status = status;
             }
         }
+        else if (arg === '--reconfigure') {
+            result.setupOptions.reconfigure = true;
+        }
         else if (!arg.startsWith('-') && !result.command) {
             result.command = arg;
         }
@@ -83,7 +88,7 @@ function parseArgs(args) {
 }
 async function main() {
     const args = process.argv.slice(2);
-    const { command, options, help, version } = parseArgs(args);
+    const { command, options, setupOptions, help, version } = parseArgs(args);
     if (version) {
         showVersion();
         return;
@@ -95,7 +100,7 @@ async function main() {
     try {
         switch (command) {
             case 'setup':
-                await setupCommand();
+                await setupCommand(setupOptions);
                 break;
             case 'status':
                 await statusCommand();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damper/cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "CLI tool for orchestrating Damper task workflows with Claude Code",
   "author": "Damper <hello@usedamper.com>",
   "repository": {
@@ -11,6 +11,7 @@
   "homepage": "https://usedamper.com",
   "type": "module",
   "bin": {
+    "damper": "./dist/index.js",
     "damper-cli": "./dist/index.js"
   },
   "main": "./dist/index.js",