cc-brain 0.1.4 → 0.1.6

package/README.md

@@ -45,19 +45,27 @@ npm install -g cc-brain
 cc-brain install
 ```
 
-### npx (no install)
+### npx (one-liner)
 ```bash
 npx cc-brain install
 ```
 
-### bunx
+### bun
 ```bash
-bunx cc-brain install
+bun install -g cc-brain
+cc-brain install
+```
+
+### GitHub Packages
+```bash
+npm install -g @tripzcodes/cc-brain --registry=https://npm.pkg.github.com
+cc-brain install
 ```
 
-### Claude Plugin
+### Upgrade
 ```bash
-claude plugins add cc-brain
+npm install -g cc-brain@latest
+cc-brain install
 ```
 
 ---
@@ -145,25 +153,27 @@ claude plugins add cc-brain
 
 ---
 
-## Commands
+## Skills
 
-Use these skills in Claude Code:
+Skills are installed to `~/.claude/skills/` and available in Claude Code:
 
-| Command | Description |
-|---------|-------------|
+| Skill | Description |
+|-------|-------------|
 | `/save` | Save session context to brain |
 | `/recall <query>` | Search archive for past context |
 | `/brain` | View current brain state |
 
+Skills are automatically discovered by Claude Code after installation.
+
 ---
 
 ## CLI
 
 ```bash
 # Setup
-cc-brain install              # Install hooks (merges with existing)
-cc-brain uninstall            # Remove hooks (preserves user hooks)
-cc-brain uninstall --purge    # Remove everything
+cc-brain install              # Install hooks + skills
+cc-brain uninstall            # Remove hooks + skills (preserves brain data)
+cc-brain uninstall --purge    # Remove everything including brain data
 
 # Search & Archive
 cc-brain recall "query"       # Search archive (scored results)
@@ -201,8 +211,8 @@ skills/
   recall.md           /recall skill
   brain.md            /brain skill
 scripts/
-  install.js          Install hooks (merges, preserves existing)
-  uninstall.js        Remove hooks (filters cc-brain only)
+  install.js          Install hooks + skills to ~/.claude/
+  uninstall.js        Remove hooks + skills (--purge for full removal)
 ```
 
 ---

package/hooks/hooks.json

@@ -5,7 +5,7 @@
       "hooks": [
         {
           "type": "command",
-          "command": "bun \"$CLAUDE_PROJECT_DIR/src/loader.js\"",
+          "command": "npx cc-brain load",
           "timeout": 5,
           "statusMessage": "Loading brain..."
         }
@@ -17,7 +17,7 @@
       "hooks": [
         {
           "type": "agent",
-          "prompt": "Context is being compacted. Save important information using the structured saver.\n\nANALYZE this session for:\n- New user insights (T1 - rare)\n- New preferences (T1 - rare)\n- Project decisions + rationale (T2)\n- Current focus/state (T2)\n- Session summary (T3 - if significant)\n\nBUILD JSON payload:\n```json\n{\n  \"t2\": {\n    \"what\": \"Project description\",\n    \"focus\": [\"current tasks\"],\n    \"decisions\": {\"decision\": \"rationale\"}\n  },\n  \"t3\": \"Session summary if significant work done.\"\n}\n```\n\nSAVE using:\n```bash\nbun src/saver.js --json '<payload>'\n```\n\nRules:\n- Only include tiers with new info\n- T2 updates are common, T1 updates are rare\n- Decisions need rationale\n- Keep it concise",
+          "prompt": "Context is being compacted. Save important information using the structured saver.\n\nANALYZE this session for:\n- New user insights (T1 - rare)\n- New preferences (T1 - rare)\n- Project decisions + rationale (T2)\n- Current focus/state (T2)\n- Session summary (T3 - if significant)\n\nBUILD JSON payload:\n```json\n{\n  \"t2\": {\n    \"what\": \"Project description\",\n    \"focus\": [\"current tasks\"],\n    \"decisions\": {\"decision\": \"rationale\"}\n  },\n  \"t3\": \"Session summary if significant work done.\"\n}\n```\n\nSAVE using:\n```bash\nnpx cc-brain save --json '<payload>'\n```\n\nRules:\n- Only include tiers with new info\n- T2 updates are common, T1 updates are rare\n- Decisions need rationale\n- Keep it concise",
           "timeout": 120,
           "statusMessage": "Saving to brain..."
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-brain",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Persistent memory system for Claude Code - remembers context across sessions",
   "type": "module",
   "bin": {
@@ -18,7 +18,7 @@
   "scripts": {
     "postinstall": "node scripts/install.js",
     "preuninstall": "node scripts/uninstall.js",
-    "test": "node src/loader.js"
+    "test": "bun test"
   },
   "keywords": [
     "claude",

package/scripts/install.js

@@ -66,9 +66,8 @@ if (existsSync(settingsPath)) {
 // Read our hooks config
 const hooks = JSON.parse(readFileSync(join(PROJECT_ROOT, 'hooks', 'hooks.json'), 'utf-8'));
 
-// Update loader path to absolute (forward slashes for cross-platform)
-const loaderPath = join(PROJECT_ROOT, 'src', 'loader.js').replace(/\\/g, '/');
-hooks.SessionStart[0].hooks[0].command = `bun "${loaderPath}"`;
+// Use npx to resolve package at runtime (works regardless of install location)
+hooks.SessionStart[0].hooks[0].command = 'npx cc-brain load';
 
 // Merge hooks — preserve user's other hooks, replace/append ours
 function isCcBrainHook(entry) {

package/src/loader.js

@@ -96,12 +96,14 @@ function loadBrain() {
   const pruned = autoPruneArchive();
 
   const parts = [];
+  let hasContent = false;
 
   parts.push('<brain>');
 
   // Show pruned files warning
   if (pruned.length > 0) {
     parts.push(`[Auto-pruned ${pruned.length} archive entries older than ${AUTO_PRUNE_DAYS} days: ${pruned.join(', ')}]\n`);
+    hasContent = true;
   }
 
   // ═══════════════════════════════════════════
@@ -113,6 +115,7 @@ function loadBrain() {
     parts.push('<user-profile>');
     parts.push(user);
     parts.push('</user-profile>');
+    hasContent = true;
   }
 
   const prefs = readIfExists(join(BRAIN_DIR, 'preferences.md'), LIMITS.preferences);
@@ -120,6 +123,7 @@ function loadBrain() {
     parts.push('<preferences>');
     parts.push(prefs);
     parts.push('</preferences>');
+    hasContent = true;
   }
 
   // ═══════════════════════════════════════════
@@ -135,6 +139,7 @@ function loadBrain() {
       parts.push(`<project id="${PROJECT_ID}">`);
       parts.push(context);
       parts.push('</project>');
+      hasContent = true;
     }
   }
 
@@ -154,14 +159,14 @@ function loadBrain() {
 
   parts.push('</brain>');
 
-  return parts.join('\n');
+  return { output: parts.join('\n'), hasContent };
 }
 
-const brain = loadBrain();
+const { output, hasContent } = loadBrain();
 
 // Only output if there's actual content
-if (brain.replace(/<\/?brain>/g, '').replace(/<[^>]+\/>/g, '').replace(/<[^>]+>[^<]*<\/[^>]+>/g, '').replace(/\[.*?\]/g, '').replace(/<!--.*?-->/g, '').trim()) {
-  console.log(brain);
+if (hasContent) {
+  console.log(output);
   console.log('\n---');
   console.log('Above is your persistent memory. Use /save to update, /recall to search archive.');
 }