grov 0.5.5 → 0.5.7

package/README.md

@@ -166,6 +166,7 @@ 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 drift-test   # Test drift detection
 ```
@@ -213,7 +214,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 +223,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

@@ -127,4 +127,12 @@ program
     const { sync } = await import('./commands/sync.js');
     await sync(options);
 }));
+// grov doctor - Diagnose setup issues
+program
+    .command('doctor')
+    .description('Check grov setup and diagnose issues')
+    .action(safeAction(async () => {
+    const { doctor } = await import('./commands/doctor.js');
+    await doctor();
+}));
 program.parse();

package/dist/commands/doctor.d.ts

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

package/dist/commands/doctor.js

@@ -0,0 +1,89 @@
+// grov doctor - Check setup and diagnose issues
+import { existsSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { request } from 'undici';
+import { readCredentials, getSyncStatus } from '../lib/credentials.js';
+import { initDatabase } from '../lib/store/database.js';
+const CLAUDE_SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
+const DB_PATH = join(homedir(), '.grov', 'memory.db');
+export async function doctor() {
+    console.log('\nGrov Doctor');
+    console.log('===========\n');
+    // Check proxy
+    const proxyRunning = await checkProxy();
+    printCheck('Proxy', proxyRunning, 'Running on port 8080', 'Not running', 'grov proxy');
+    // Check Claude settings
+    const baseUrlConfigured = checkBaseUrl();
+    printCheck('ANTHROPIC_BASE_URL', baseUrlConfigured, 'Configured for proxy', 'Not configured', 'grov init');
+    // 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'
+        ? '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');
+    // Check sync
+    const syncStatus = getSyncStatus();
+    const syncOk = syncStatus?.enabled && syncStatus?.teamId;
+    const syncMsg = syncOk
+        ? `Team ${syncStatus.teamId.substring(0, 8)}...`
+        : syncStatus?.teamId ? 'Disabled' : 'No team';
+    printCheck('Cloud Sync', !!syncOk, syncMsg, syncMsg, 'grov sync --enable --team <id>');
+    // Check database
+    const dbStats = checkDatabase();
+    const dbOk = dbStats.tasks > 0 || dbStats.sessions > 0;
+    const dbMsg = `${dbStats.tasks} tasks, ${dbStats.unsynced} unsynced, ${dbStats.sessions} active`;
+    printCheck('Local Database', dbOk, dbMsg, 'Empty', 'Use Claude Code with proxy running');
+    console.log('');
+}
+async function checkProxy() {
+    try {
+        const res = await request('http://127.0.0.1:8080/health', {
+            headersTimeout: 2000,
+            bodyTimeout: 2000
+        });
+        return res.statusCode === 200;
+    }
+    catch {
+        return false;
+    }
+}
+function checkBaseUrl() {
+    if (!existsSync(CLAUDE_SETTINGS_PATH))
+        return false;
+    try {
+        const settings = JSON.parse(readFileSync(CLAUDE_SETTINGS_PATH, 'utf-8'));
+        return settings.env?.ANTHROPIC_BASE_URL === 'http://127.0.0.1:8080';
+    }
+    catch {
+        return false;
+    }
+}
+function checkDatabase() {
+    if (!existsSync(DB_PATH)) {
+        return { tasks: 0, unsynced: 0, sessions: 0 };
+    }
+    try {
+        const db = initDatabase();
+        const tasks = db.prepare('SELECT COUNT(*) as c FROM tasks').get().c;
+        const unsynced = db.prepare('SELECT COUNT(*) as c FROM tasks WHERE synced_at IS NULL').get().c;
+        const sessions = db.prepare("SELECT COUNT(*) as c FROM session_states WHERE status = 'active'").get().c;
+        return { tasks, unsynced, sessions };
+    }
+    catch {
+        return { tasks: 0, unsynced: 0, sessions: 0 };
+    }
+}
+function printCheck(name, ok, successMsg, failMsg, fix) {
+    const icon = ok ? '\x1b[32m✓\x1b[0m' : '\x1b[31m✗\x1b[0m';
+    const msg = ok ? successMsg : failMsg;
+    console.log(`${icon} ${name}: ${msg}`);
+    if (!ok) {
+        console.log(`  \x1b[90m→ ${fix}\x1b[0m`);
+    }
+}

package/dist/commands/init.js

@@ -13,24 +13,28 @@ export async function init() {
         }
         console.log(`\nSettings file: ${getSettingsPath()}`);
         // Check for API key and provide helpful instructions
+        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');
+            console.log('  2. Add PERMANENTLY to your shell (not just "export" in terminal):');
+            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/package.json

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