grov 0.5.6 → 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/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,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.6",
+  "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",