grov 0.5.6 → 0.5.8

package/README.md

@@ -71,6 +71,8 @@ grov proxy            # Start (keep running)
 
 Then use Claude Code normally in another terminal. That's it.
 
+> **Important:** Your `ANTHROPIC_API_KEY` must be set permanently in your shell profile, not just with `export` in a terminal. See [Troubleshooting](#troubleshooting) for setup instructions.
+
 For team sync:
 ```bash
 grov login                    # Authenticate via GitHub
@@ -166,7 +168,9 @@ grov proxy-status # Show active sessions
 grov status       # Show captured tasks
 grov login        # Login to cloud dashboard
 grov sync         # Sync memories to team dashboard
+grov doctor       # Diagnose setup issues
 grov disable      # Disable grov
+grov uninstall    # Remove all grov data and config
 grov drift-test   # Test drift detection
 ```
 
@@ -213,7 +217,7 @@ Browse, search, and manage your team's AI knowledge at [app.grov.dev](https://ap
 ## Environment Variables
 
 ```bash
-# Required for drift detection and LLM extraction
+# Required for memory sync and drift detection
 export ANTHROPIC_API_KEY=sk-ant-...
 
 # Optional
@@ -222,7 +226,45 @@ export PROXY_HOST=127.0.0.1                        # Proxy host
 export PROXY_PORT=8080                             # Proxy port
 ```
 
-Without an API key, Grov uses basic extraction and disables drift detection.
+Without an API key, Grov uses basic extraction and **memories will not sync**.
+
+---
+
+## Troubleshooting
+
+### Memories not syncing?
+
+Run `grov doctor` to diagnose:
+
+```bash
+grov doctor
+```
+
+This checks your proxy, API key, login, sync status, and local database.
+
+### ⚠️ Common Issue: API Key Not Persisting
+
+**Using `export ANTHROPIC_API_KEY=...` directly in terminal only works in THAT terminal session.** When you open a new terminal, the key is gone.
+
+**Fix:** Add the key to your shell profile so it persists:
+
+```bash
+# For zsh (macOS default):
+echo 'export ANTHROPIC_API_KEY=sk-ant-...' >> ~/.zshrc
+source ~/.zshrc
+
+# For bash:
+echo 'export ANTHROPIC_API_KEY=sk-ant-...' >> ~/.bashrc
+source ~/.bashrc
+```
+
+Then run `grov doctor` to verify:
+
+```
+✓ ANTHROPIC_API_KEY: Set
+```
+
+Get your API key at: https://console.anthropic.com/settings/keys
 
 ---
 

package/dist/cli.js

@@ -114,6 +114,14 @@ program
     const { logout } = await import('./commands/logout.js');
     await logout();
 }));
+// grov uninstall - Full cleanup
+program
+    .command('uninstall')
+    .description('Remove all grov data and configuration')
+    .action(safeAction(async () => {
+    const { uninstall } = await import('./commands/uninstall.js');
+    await uninstall();
+}));
 // grov sync - Configure cloud sync
 program
     .command('sync')

package/dist/commands/doctor.js

@@ -19,10 +19,11 @@ export async function doctor() {
     // Check API key
     const apiKey = process.env.ANTHROPIC_API_KEY;
     const hasApiKey = !!(apiKey && apiKey.length > 10);
+    const shell = process.env.SHELL?.includes('zsh') ? '~/.zshrc' : '~/.bashrc';
     const apiKeyFix = process.platform === 'win32'
-        ? 'set ANTHROPIC_API_KEY=sk-ant-...'
-        : 'export ANTHROPIC_API_KEY=sk-ant-... (add to shell profile)';
-    printCheck('ANTHROPIC_API_KEY', hasApiKey, 'Set', 'Not set (task detection disabled)', apiKeyFix);
+        ? 'setx ANTHROPIC_API_KEY "sk-ant-..." (permanent) or add to System Environment Variables'
+        : `Add to ${shell}: echo 'export ANTHROPIC_API_KEY=sk-ant-...' >> ${shell} && source ${shell}`;
+    printCheck('ANTHROPIC_API_KEY', hasApiKey, 'Set', 'NOT SET - memories will not sync!', apiKeyFix);
     // Check login
     const creds = readCredentials();
     printCheck('Login', !!creds, creds ? `Logged in as ${creds.email}` : 'Not logged in', 'Not logged in', 'grov login');

package/dist/commands/init.js

@@ -13,24 +13,37 @@ export async function init() {
         }
         console.log(`\nSettings file: ${getSettingsPath()}`);
         // Check for API key and provide helpful instructions
+        const isWindows = process.platform === 'win32';
+        const shell = process.env.SHELL?.includes('zsh') ? '~/.zshrc' : '~/.bashrc';
         if (!process.env.ANTHROPIC_API_KEY) {
-            console.log('\n' + '='.repeat(50));
-            console.log('  ANTHROPIC_API_KEY not found');
-            console.log('='.repeat(50));
-            console.log('\nTo enable drift detection and smart extraction:\n');
-            console.log('  1. Get your API key at:');
+            console.log('\n╔═══════════════════════════════════════════════════════════╗');
+            console.log('║  ⚠️  ANTHROPIC_API_KEY NOT SET - MEMORIES WILL NOT SYNC!  ║');
+            console.log('╚═══════════════════════════════════════════════════════════╝');
+            console.log('\n  1. Get your API key at:');
             console.log('     https://console.anthropic.com/settings/keys\n');
-            console.log('  2. Add to your shell profile (~/.zshrc or ~/.bashrc):');
-            console.log('     export ANTHROPIC_API_KEY=sk-ant-...\n');
-            console.log('  3. Restart terminal or run: source ~/.zshrc\n');
+            if (isWindows) {
+                console.log('  2. Set PERMANENTLY (run in Command Prompt as Admin):');
+                console.log('     setx ANTHROPIC_API_KEY "sk-ant-..."\n');
+                console.log('  3. Restart your terminal\n');
+                console.log('  ⚠️  Using "set" alone only works in THAT terminal!');
+            }
+            else {
+                console.log('  2. Add PERMANENTLY to your shell:');
+                console.log(`     echo 'export ANTHROPIC_API_KEY=sk-ant-...' >> ${shell}\n`);
+                console.log('  3. Apply changes:');
+                console.log(`     source ${shell}\n`);
+                console.log('  ⚠️  Using "export" alone only works in THAT terminal!');
+            }
+            console.log('     The key will be gone when you open a new terminal.\n');
         }
         else {
-            console.log('\n  ANTHROPIC_API_KEY found');
+            console.log('\n  ✓ ANTHROPIC_API_KEY found');
         }
         console.log('\n--- Next Steps ---');
         console.log('1. Terminal 1: grov proxy');
         console.log('2. Terminal 2: claude');
-        console.log('\nGrov will automatically capture reasoning and inject context.');
+        console.log('\nRun "grov doctor" to verify your setup is complete.');
+        console.log('Grov will automatically capture reasoning and inject context.');
     }
     catch (error) {
         console.error('Failed to configure grov:', error instanceof Error ? error.message : 'Unknown error');

package/dist/commands/login.js

@@ -142,8 +142,17 @@ export async function login() {
                     console.log('║                                         ║');
                     console.log('╚═════════════════════════════════════════╝');
                     console.log(`\nSyncing to: ${selectedTeam.name}`);
-                    console.log('\nYou\'re all set! Your AI sessions will now be saved.');
-                    console.log('View them at: https://app.grov.dev/memories\n');
+                    // Check API key and warn if not set
+                    if (!process.env.ANTHROPIC_API_KEY) {
+                        const shell = process.env.SHELL?.includes('zsh') ? '~/.zshrc' : '~/.bashrc';
+                        console.log('\n⚠️  WARNING: ANTHROPIC_API_KEY not set - memories will NOT sync!');
+                        console.log('\n   Add PERMANENTLY to your shell (not just "export"):');
+                        console.log(`   echo 'export ANTHROPIC_API_KEY=sk-ant-...' >> ${shell}`);
+                        console.log(`   source ${shell}`);
+                        console.log('\n   Get your key at: https://console.anthropic.com/settings/keys');
+                    }
+                    console.log('\nRun "grov doctor" to verify your setup is complete.');
+                    console.log('View memories at: https://app.grov.dev/memories\n');
                 }
                 else {
                     console.log('\n✓ Logged in. Sync not enabled.');

package/dist/commands/uninstall.d.ts

@@ -0,0 +1 @@
+export declare function uninstall(): Promise<void>;

package/dist/commands/uninstall.js

@@ -0,0 +1,49 @@
+// grov uninstall - Full cleanup and removal
+import { rmSync, existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import * as readline from 'readline';
+import { setProxyEnv } from '../lib/settings.js';
+import { clearCredentials } from '../lib/credentials.js';
+const GROV_DIR = join(homedir(), '.grov');
+function prompt(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase());
+        });
+    });
+}
+export async function uninstall() {
+    console.log('\nGrov Uninstall');
+    console.log('==============\n');
+    console.log('This will remove:');
+    console.log('  - Proxy config from ~/.claude/settings.json (ANTHROPIC_BASE_URL only)');
+    console.log('  - Login credentials (~/.grov/credentials.json)');
+    console.log('  - Local database (~/.grov/memory.db)');
+    console.log('  - All files in ~/.grov/\n');
+    const confirm = await prompt('Continue? [y/N]: ');
+    if (confirm !== 'y' && confirm !== 'yes') {
+        console.log('Cancelled.\n');
+        return;
+    }
+    // Remove proxy config from Claude settings
+    const result = setProxyEnv(false);
+    if (result.action === 'removed') {
+        console.log('✓ Removed proxy config from Claude settings');
+    }
+    // Clear credentials
+    clearCredentials();
+    console.log('✓ Cleared login credentials');
+    // Remove ~/.grov folder
+    if (existsSync(GROV_DIR)) {
+        rmSync(GROV_DIR, { recursive: true, force: true });
+        console.log('✓ Removed ~/.grov folder (database, logs)');
+    }
+    console.log('\nGrov data removed. To complete uninstall, run:');
+    console.log('  npm uninstall -g grov\n');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grov",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "description": "Collective AI memory for Claude Code - captures reasoning from sessions and injects context into future sessions",
   "type": "module",
   "main": "dist/cli.js",