eagle-mem 2.0.4 → 2.0.6

package/README.md

@@ -18,7 +18,7 @@ npm install -g eagle-mem
 eagle-mem install
 ```
 
-**2. Open Claude Code** in any project directory. Eagle Mem activates automatically:
+**2. Open Claude Code** in any project directory. Eagle Mem activates and shows what it loaded:
 
 ```
 █▀▀ ▄▀█ █▀▀ █   █▀▀   █▀▄▀█ █▀▀ █▀▄▀█
@@ -29,34 +29,116 @@ Sessions: 5 recent | Memories: 3 | Tasks: 2 pending
 Last: Added auth middleware with JWT validation
 ```
 
-**3. That's it.** Everything else is automatic:
-- Session summaries captured on every Claude turn
-- Claude's memories, plans, and tasks mirrored into Eagle Mem
-- Full context re-injected after every `/compact`, `/clear`, or new session
-- Past sessions searched on every prompt via FTS5
+From here, everything is automatic. You don't run any commands — Eagle Mem captures session summaries, mirrors Claude's memories and tasks, and re-injects context after every `/compact` or new session.
 
-> **Have existing Claude Code history?** Run `eagle-mem refresh` inside your project directory to backfill — it scans your codebase, indexes source files, and imports all existing memories, plans, and tasks.
+**3. Already have Claude Code history on a project?** Run this inside the project directory:
 
-## Day-to-day usage
+```bash
+cd ~/projects/my-app
+eagle-mem refresh
+```
+
+This backfills everything into Eagle Mem:
+
+```
+Eagle Mem  Refresh
+─────────────────────────────────────
+
+Step 1/4: Scanning codebase structure...
+  ✓  120 files found
+  ✓  Languages: TypeScript (15k lines), CSS (2k lines)
+  ✓  Frameworks: Next.js, React, Tailwind, Prisma
+  ✓  Scan complete
+
+Step 2/4: Indexing source files...
+  ✓  Index complete
+
+Step 3/4: Syncing Claude Code memories, plans, and tasks...
+  ✓  Memory sync complete
+
+Step 4/4: Verifying...
+  Sessions:    12
+  Code chunks: 340
+  Memories:    8
+  Tasks:       15
+```
 
-Most of the time you don't run anything manually. The hooks handle everything. But when you need to:
+Now open Claude Code in that project — it sees your full history from the start.
 
-| When | What to do |
-|------|-----------|
-| Search past sessions | `eagle-mem search "auth middleware"` |
-| See recent timeline | `eagle-mem search --timeline` |
-| View project overview | `eagle-mem overview` |
-| Set a custom overview | `eagle-mem overview set "..."` |
-| Full re-sync after major changes | `eagle-mem refresh .` |
-| Clean up old data | `eagle-mem prune` |
+## Commands
 
-Inside Claude Code, you also have skills (slash commands):
+Eagle Mem gives you terminal commands for when you need to look something up or manage your data outside of Claude Code.
 
-| Skill | When to use it |
-|-------|---------------|
-| `/eagle-mem-search` | Find something from a past session |
-| `/eagle-mem-overview` | Build a rich project briefing from code + README + git |
-| `/eagle-mem-tasks` | Break complex work into tasks that survive `/compact` |
+### Search past sessions
+
+```bash
+eagle-mem search "auth middleware"
+```
+
+Searches across session summaries, Claude memories, and indexed code using FTS5. Use this when you know you worked on something last week but can't remember the details.
+
+```bash
+eagle-mem search --timeline
+```
+
+Shows your most recent sessions in chronological order — useful for catching up after a break.
+
+### View or set your project overview
+
+```bash
+eagle-mem overview
+```
+
+Shows the overview that gets injected into every Claude Code session. This is what Claude reads first to understand your project.
+
+```bash
+eagle-mem overview set "My app is a Next.js dashboard for monitoring API health..."
+```
+
+Set a custom overview. You can also let Claude write one for you by running `/eagle-mem-overview` inside a Claude Code session — it reads your README, entry points, and git history to synthesize one.
+
+### Sync everything
+
+```bash
+eagle-mem refresh
+```
+
+Run this inside a project directory after major changes (new packages, restructured directories, pulling a large branch). It re-scans the codebase, re-indexes source files, and syncs any new Claude Code memories and tasks.
+
+### Other commands
+
+| Command | When to use it |
+|---------|---------------|
+| `eagle-mem scan` | Re-analyze codebase structure (languages, frameworks, entry points) |
+| `eagle-mem index` | Re-index source files for code search |
+| `eagle-mem memories` | View or sync mirrored Claude Code memories and plans |
+| `eagle-mem tasks` | View mirrored Claude Code tasks |
+| `eagle-mem prune` | Clean up old observations and orphaned code chunks |
+
+## Skills (inside Claude Code)
+
+Inside a Claude Code session, you have slash commands that let Claude do the work for you:
+
+### `/eagle-mem-search`
+
+Search past sessions from within Claude Code. Claude interprets results and connects them to your current work — better than raw terminal search when you need context, not just a match.
+
+### `/eagle-mem-overview`
+
+Build a rich project briefing. Claude reads your README, entry points, recent git history, and current codebase to write a 2-3 paragraph overview that captures what the project *does*, not just its file counts. This overview is injected at every session start.
+
+### `/eagle-mem-tasks`
+
+Break complex work into tasks that survive `/compact`. Uses Claude Code's native `TaskCreate`/`TaskUpdate` with dependency support. When context fills up and you compact, Eagle Mem re-injects the task state so Claude picks up where it left off.
+
+### Other skills
+
+| Skill | What it does |
+|-------|-------------|
+| `/eagle-mem-scan` | Analyze codebase structure — languages, frameworks, entry points |
+| `/eagle-mem-index` | Index source files for FTS5 code search |
+| `/eagle-mem-memories` | View, search, and sync Claude Code's mirrored memories and plans |
+| `/eagle-mem-prune` | Database hygiene — graduated cleanup of stale data |
 
 ## Updating
 
@@ -92,36 +174,6 @@ Data lives in a single SQLite database at `~/.eagle-mem/memory.db` (WAL mode, FT
 | claude_plans | Mirror of Claude Code plans |
 | claude_tasks | Mirror of Claude Code tasks |
 
-## All commands
-
-| Command | What it does |
-|---------|-------------|
-| `eagle-mem install` | First-time setup: hooks, database, skills |
-| `eagle-mem update` | Re-deploy hooks and run pending migrations |
-| `eagle-mem uninstall` | Remove hooks and optionally delete data |
-| `eagle-mem refresh` | Full sync: scan + index + memories in one command |
-| `eagle-mem search <query>` | FTS5 search across summaries, memories, and code |
-| `eagle-mem overview` | View or set the project overview |
-| `eagle-mem scan` | Analyze codebase structure |
-| `eagle-mem index` | Index source files for code search |
-| `eagle-mem memories` | View/sync mirrored Claude Code memories and plans |
-| `eagle-mem tasks` | View mirrored Claude Code tasks |
-| `eagle-mem prune` | Remove old observations and orphaned chunks |
-
-## All skills
-
-Seven skills available inside Claude Code sessions:
-
-| Skill | What it does |
-|-------|-------------|
-| `/eagle-mem-search` | Progressive memory recall — search, expand, drill into sessions |
-| `/eagle-mem-overview` | Build a structured project briefing from code, README, and git history |
-| `/eagle-mem-scan` | Analyze codebase structure — languages, frameworks, entry points |
-| `/eagle-mem-index` | Index source files for FTS5 code search across sessions |
-| `/eagle-mem-memories` | View, search, and sync Claude Code's mirrored memories and plans |
-| `/eagle-mem-tasks` | TaskAware Compact Loop — break work into tasks that survive compaction |
-| `/eagle-mem-prune` | Database hygiene — graduated cleanup of stale data |
-
 ## Uninstall
 
 ```bash

package/hooks/session-start.sh

@@ -38,6 +38,34 @@ eagle_db "UPDATE sessions SET status = 'abandoned'
     AND id != '$(eagle_sql_escape "$session_id")'
     AND COALESCE(last_activity_at, started_at) < strftime('%Y-%m-%dT%H:%M:%fZ', 'now', '-7 days');"
 
+# ─── Version check (non-blocking) ────────────────────────────
+
+update_notice=""
+version_file="$EAGLE_MEM_DIR/.version"
+latest_file="$EAGLE_MEM_DIR/.latest-version"
+
+if [ -f "$version_file" ] && [ -s "$version_file" ]; then
+    installed_version=$(tr -d '[:space:]' < "$version_file")
+
+    if [ -f "$latest_file" ] && [ -s "$latest_file" ]; then
+        latest_version=$(tr -d '[:space:]' < "$latest_file")
+        newest=$(printf '%s\n' "$installed_version" "$latest_version" | sort -V | tail -1)
+        if [ "$newest" != "$installed_version" ]; then
+            update_notice="Update available: v${installed_version} → v${latest_version} — run: npm update -g eagle-mem && eagle-mem update"
+        fi
+    fi
+
+    if [ ! -f "$latest_file" ] || [ -n "$(find "$latest_file" -mtime +0 2>/dev/null)" ]; then
+        (tmp_latest=$(mktemp)
+         npm view eagle-mem version 2>/dev/null | tr -d '[:space:]' > "$tmp_latest"
+         if [ -s "$tmp_latest" ]; then
+             mv "$tmp_latest" "$latest_file"
+         else
+             rm -f "$tmp_latest"
+         fi) &
+    fi
+fi
+
 # ─── Build context injection ────────────────────────────────
 
 eagle_logo="█▀▀ ▄▀█ █▀▀ █   █▀▀   █▀▄▀█ █▀▀ █▀▄▀█
@@ -50,6 +78,12 @@ Eagle Mem (https://github.com/eagleisbatman/eagle-mem) is providing persistent m
 
 "
 
+if [ -n "$update_notice" ]; then
+    context+="=== EAGLE MEM — $update_notice ===
+
+"
+fi
+
 # Project overview
 overview=$(eagle_get_overview "$project")
 if [ -n "$overview" ]; then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eagle-mem",
-  "version": "2.0.4",
+  "version": "2.0.6",
   "description": "Persistent memory for Claude Code — SQLite + FTS5, no daemon, no bloat",
   "bin": {
     "eagle-mem": "bin/eagle-mem"

package/scripts/install.sh

@@ -242,6 +242,11 @@ else
     fi
 fi
 
+# ─── Save installed version ───────────────────────────────
+
+version=$(jq -r .version "$PACKAGE_DIR/package.json" 2>/dev/null || echo "unknown")
+echo "$version" > "$EAGLE_MEM_DIR/.version"
+
 # ─── Summary ───────────────────────────────────────────────
 
 eagle_footer "Eagle Mem installed successfully."

package/scripts/update.sh

@@ -106,7 +106,9 @@ else
     eagle_ok "Project names up to date"
 fi
 
-# ─── Summary ───────────────────────────────────────────────
+# ─── Save installed version ───────────────────────────────
 
 version=$(jq -r .version "$PACKAGE_DIR/package.json" 2>/dev/null || echo "unknown")
+echo "$version" > "$EAGLE_MEM_DIR/.version"
+
 eagle_footer "Eagle Mem updated to v${version}."