eagle-mem 4.9.9 → 4.10.0

package/README.md

@@ -7,11 +7,11 @@
 
 # Eagle Mem
 
-**Shared memory, release guardrails, and worker lanes for Claude Code and Codex.**
+**Shared memory, release guardrails, and worker lanes for Claude Code, Codex, and Grok-assisted workflows.**
 
-Eagle Mem turns AI coding sessions into compounding project knowledge. It gives Claude Code and Codex the same local memory, labels which agent created each memory, blocks risky release commands until affected features are verified, and lets broad work split into durable worker lanes.
+Eagle Mem turns AI coding sessions into compounding project knowledge. It gives Claude Code and Codex hook-backed shared memory, gives Grok the same skills and CLI memory surface, labels which agent created each memory, blocks risky release commands until affected features are verified, and lets broad work split into durable worker lanes.
 
-**v4.9.7 focuses on distribution trust and visible UX:** `eagle-mem doctor` now checks the installed runtime, selected SQLite/FTS5 binary, hooks, statusline wiring, install manifest, and runtime drift. Install/update show a clear "what will change" preflight, uninstall supports dry-run cleanup with backups, and statuslines now resolve the live session project so brand-new projects do not inherit old memory/session counts.
+**v4.10.0 focuses on Grok support and Compaction Survival:** Grok users now get first-class skill linking and `eagle-mem grok-bootstrap`, while all agents can inspect project-level compaction readiness with `eagle-mem compaction`. Claude Code and Codex continue to get the deepest automatic lifecycle support through hooks; Grok currently uses the shared CLI and skill workflow until native lifecycle hooks are available.
 
 **Website:** [Product](https://eagleisbatman.github.io/eagle-mem/) |
 [Architecture](https://eagleisbatman.github.io/eagle-mem/architecture.html) |
@@ -41,7 +41,7 @@ Eagle Mem is a local runtime layer for AI coding agents. It adds three things th
 | **Guardrails** | "The agent cannot casually undo known decisions or push unverified feature changes." | Surfaces decisions before edits and enforces feature verification on push, PR, and publish boundaries. |
 | **Lanes** | "A big task can survive compaction and split across agents." | Persists orchestrations, worker lanes, worktrees, logs, validation commands, and handoffs. |
 
-Both agents share the same SQLite database at `~/.eagle-mem/memory.db`, and captured rows are source-attributed as `Claude Code` or `Codex`.
+Claude Code and Codex share the same SQLite database at `~/.eagle-mem/memory.db`, and captured rows are source-attributed as `Claude Code` or `Codex`. Grok uses the same database through skills and CLI commands, with native lifecycle capture reserved for a future adapter.
 
 **Zero per-instance overhead.** No daemon, no vector DB, no MCP server. Just bash scripts, sqlite3 (WAL mode, FTS5 full-text search), and jq.
 
@@ -66,17 +66,17 @@ eagle-mem install
 eagle-mem doctor
 ```
 
-That's it. `doctor` should report a healthy install. Open Claude Code or Codex in any project directory and Eagle Mem activates automatically.
+That's it. `doctor` should report a healthy install. Open Claude Code or Codex in any project directory and Eagle Mem activates automatically. For Grok, run `eagle-mem grok-bootstrap` after install to confirm the linked skills and CLI workflow.
 
-Everything is automatic from here. Eagle Mem scans your codebase, indexes source files, captures session summaries, mirrors Claude's memories and tasks, learns which commands are noisy, prunes stale data, and installs patch bug fixes — all in the background via hooks.
+For Claude Code and Codex, everything is automatic from here. Eagle Mem scans your codebase, indexes source files, captures session summaries, mirrors Claude's memories and tasks, learns which commands are noisy, prunes stale data, and installs patch bug fixes — all in the background via hooks.
 
-For Codex, the installer enables `codex_hooks` in `~/.codex/config.toml`, registers hooks in `~/.codex/hooks.json`, symlinks Eagle Mem skills into `~/.codex/skills`, and patches `~/.codex/AGENTS.md` with the Eagle Mem summary contract. For Claude Code, it keeps using `~/.claude/settings.json`, `CLAUDE.md`, `~/.claude/skills`, and the existing Claude memory/task locations.
+For Codex, the installer enables `codex_hooks` in `~/.codex/config.toml`, registers hooks in `~/.codex/hooks.json`, symlinks Eagle Mem skills into `~/.codex/skills`, and patches `~/.codex/AGENTS.md`. For Claude Code, it integrates with `~/.claude/settings.json`, `CLAUDE.md`, and `~/.claude/skills`. Grok users get skill symlinks into `~/.grok/skills/` and can run `eagle-mem grok-bootstrap` for setup guidance and self-linking.
 
 ### Prerequisites
 
 - `sqlite3` with FTS5 support (ships with macOS; Eagle Mem prefers known system/Homebrew SQLite binaries before PATH shims)
 - `jq` (the installer offers to install if missing)
-- [Claude Code](https://docs.anthropic.com/en/docs/claude-code), Codex, or both installed
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code), Codex, or a Grok environment (`~/.grok/`)
 
 ## How It Works
 
@@ -108,6 +108,12 @@ These run automatically via SessionStart — no commands needed:
 
 Eagle Mem actively reduces token consumption:
 
+### Compaction Survival
+
+One of the core promises of Eagle Mem is protecting against `/compact` and session amnesia. Compaction Survival is project-level, not Grok-specific: it reads shared Eagle Mem state such as durable tasks, enriched summaries, stale work, and orchestration lanes. Claude Code and Codex get automatic hook-backed recovery through SessionStart, Stop, task mirroring, and context-pressure nudges. Grok can inspect and use the same state through `eagle-mem compaction`, `eagle-mem tasks`, and the linked skills, but does not yet have native lifecycle hooks.
+
+Run `eagle-mem compaction` anytime to check readiness.
+
 - **Injection compression** — zero-value stats are elided from the banner, overview is capped, compact reloads get 1 recent session instead of 3
 - **Command rewriting** — PreToolUse routes noisy shell output through RTK when available and blocks known raw-output commands in enforce mode when RTK is missing.
 - **Read-after-modify detection** — detects when you read a file that was just edited or written, nudges that the diff is already in context
@@ -150,6 +156,9 @@ Eagle Mem prevents Claude from repeating past mistakes:
 | `eagle-mem orchestrate` | Coordinate durable worker lanes across agents |
 | `eagle-mem curate` | Run curator (co-edits, hot files, guardrails) |
 | `eagle-mem feature` | Track and verify features |
+| `eagle-mem compaction` | Check Compaction Survival status and readiness |
+| `eagle-mem grok-bootstrap` | Set up and verify Grok integration |
+| `eagle-mem test` | Run basic smoke tests for the memory layer |
 | `eagle-mem prune` | Clean old sessions and stale data |
 | `eagle-mem scan` | Scan codebase and generate overview |
 | `eagle-mem index` | Index source files for FTS5 code search |
@@ -168,6 +177,16 @@ Install and update print the files/configs they intend to touch before they chan
 
 Uninstall removes Claude Code and Codex hook registrations, Eagle Mem instruction blocks, custom Claude statusline integration, and skill links. It backs up user config files before editing them and keeps `~/.eagle-mem/memory.db` unless you explicitly confirm data deletion.
 
+### v4.10.0 Minor Release
+
+This release makes Eagle Mem broader and safer across agent workflows:
+
+- Grok is now a first-class skill/CLI target: install detects `~/.grok`, links Eagle Mem skills into `~/.grok/skills`, and adds `eagle-mem grok-bootstrap`.
+- `eagle-mem compaction` reports Compaction Survival readiness from shared project state: enriched summaries, durable tasks, stale tasks, active lanes, and last durable update.
+- `eagle-mem test` provides a built-in smoke harness for the memory layer.
+- `eagle-mem tasks stale` and `[STALE - Nd]` warnings make long-running task drift visible.
+- `eagle-mem health` now surfaces orchestration lanes, learned command rules, and curator timing.
+
 ### v4.9.7 Patch
 
 This patch is a release-readiness and UX-hardening pass:
@@ -295,17 +314,17 @@ Both agents write to `~/.eagle-mem/memory.db`:
 - mirrored memories, plans, and tasks include `origin_agent`
 - SessionStart recall labels sources as `Claude Code` or `Codex`
 
-That means opening the same project in Claude Code and Codex does not create two isolated memory worlds. They recall the same project history while preserving the source of each memory.
+That means opening the same project in Claude Code and Codex does not create two isolated memory worlds. They recall the same project history while preserving the source of each memory. Grok can search, inspect, and update that same project memory through the linked skills and CLI commands.
 
-## Skills (Inside Claude Code and Codex)
+## Skills (Inside Claude Code, Codex, and Grok)
 
 | Skill | What It Does |
 |-------|-------------|
-| `/eagle-mem-search` | Search memory and past sessions — Claude interprets results in context |
+| `/eagle-mem-search` | Search memory and past sessions — the active agent interprets results in context |
 | `/eagle-mem-overview` | Build a rich project briefing from README, entry points, and git history |
 | `/eagle-mem-memories` | View and search mirrored agent memories and plans |
 | `/eagle-mem-tasks` | TaskAware Compact Loop — break complex work into tasks that survive `/compact` |
-| `/eagle-mem-orchestrate` | Orchestrator/worker lane handoffs across Claude Code and Codex |
+| `/eagle-mem-orchestrate` | Orchestrator/worker lane handoffs across Claude Code and Codex, with shared CLI visibility for Grok |
 
 ## Data
 
@@ -362,6 +381,17 @@ eagle-mem config set token_guard.rtk off       # disable RTK behavior
 eagle-mem config set token_guard.raw_bash block
 ```
 
+## Long-term Direction
+
+The current implementation is pure Bash + SQLite (with FTS5) for maximum portability, zero runtime dependencies, and easy auditing. This has proven effective for the core goals of recall, guardrails, and cross-agent coordination.
+
+Future evolution paths under consideration (Phase 3 work):
+- Incremental native helpers in Rust for hot paths (large FTS searches, heavy curation workloads, very large observation tables)
+- Optional full Rust runtime for the core if Bash becomes a bottleneck on extremely long-lived projects
+- Deeper native hooks and recall injection for additional agent environments
+
+The guiding principles remain the same: local-only, no daemon, no vector database, strong anti-regression guarantees, and excellent visibility for the human using the agents.
+
 ## License
 
 MIT

package/architecture.html

@@ -683,7 +683,7 @@
       <div class="brand">
         <span class="brand-label">Eagle Mem</span>
         <h1>Agent Architecture Tutorial</h1>
-        <p>Technical architecture plus UX architecture for Claude Code, Codex, and future coding agents.</p>
+        <p>Technical architecture plus UX architecture for Claude Code, Codex, Grok, and future coding agents.</p>
       </div>
 
       <p class="nav-title">Start Here</p>
@@ -719,7 +719,7 @@
     <main id="main">
       <section class="hero" id="purpose">
         <div class="hero-inner">
-          <p class="eyebrow">Architecture guide - technical + UX - updated 2026-05-05</p>
+          <p class="eyebrow">Architecture guide - technical + UX - updated 2026-05-22</p>
           <h2>Eagle Mem is a local memory and safety layer that makes AI coding agents start warmer, ship safer, and coordinate better.</h2>
           <p class="hero-summary">
             This tutorial explains the project from first principles. You do not need to know the codebase first. Read it like a guided tour: what problem Eagle Mem solves, how hooks move data through the system, how SQLite stores shared memory, and why the user experience is intentionally quiet until the agent needs help.
@@ -732,7 +732,7 @@
             </div>
             <div class="meta-box">
               <strong>Agents</strong>
-              <span>Claude Code and Codex today; adapter contract for more agents later.</span>
+              <span>Claude Code and Codex with hooks; Grok through skills and CLI today.</span>
             </div>
             <div class="meta-box">
               <strong>Core Promise</strong>
@@ -791,6 +791,11 @@
             <p>Eagle Mem is not a hosted memory service. It is not a vector database. It is a local runtime made of hook scripts, CLI commands, and a SQLite database. Agents keep working in their normal terminal UI, while Eagle Mem quietly injects context, records what happened, and blocks risky release boundaries when verification is still pending.</p>
           </div>
 
+          <div class="callout">
+            <h3>Compaction Survival is shared state</h3>
+            <p><code>eagle-mem compaction</code> is not a Grok-only feature. It reads project-level state from SQLite: enriched summaries, durable tasks, stale tasks, active orchestration lanes, and recent durable updates. Claude Code and Codex have hook-backed automatic recovery around compact and clear events. Grok can use the same state through linked skills and CLI commands until native lifecycle hooks exist.</p>
+          </div>
+
           <h3>Vocabulary</h3>
           <table>
             <thead>
@@ -857,7 +862,7 @@
               <text x="40" y="42" class="label">User Layer</text>
               <rect x="40" y="58" width="220" height="72" class="box-cyan"></rect>
               <text x="62" y="90">Developer</text>
-              <text x="62" y="112" class="small">Works in Claude Code or Codex</text>
+              <text x="62" y="112" class="small">Works in Claude Code, Codex, or Grok</text>
 
               <text x="40" y="178" class="label">Agent Layer</text>
               <rect x="40" y="194" width="220" height="78" class="box"></rect>
@@ -935,7 +940,7 @@
               <div class="step-num">2</div>
               <div>
                 <h3>Prerequisites are checked</h3>
-                <p>The installer checks for an FTS5-capable <code>sqlite3</code>, <code>jq</code>, optional <code>rtk</code>, and at least one supported agent installation. FTS5 matters because summaries, code chunks, and mirrored artifacts are searched with SQLite full-text search.</p>
+                <p>The installer checks for an FTS5-capable <code>sqlite3</code>, <code>jq</code>, optional <code>rtk</code>, and at least one supported agent environment. FTS5 matters because summaries, code chunks, and mirrored artifacts are searched with SQLite full-text search.</p>
               </div>
             </article>
 
@@ -959,7 +964,7 @@
               <div class="step-num">5</div>
               <div>
                 <h3>Agent hooks are registered</h3>
-                <p>Claude Code hooks are patched into <code>~/.claude/settings.json</code>. Codex hooks are registered in <code>~/.codex/hooks.json</code>, and <code>codex_hooks = true</code> is enabled in <code>~/.codex/config.toml</code>.</p>
+                <p>Claude Code hooks are patched into <code>~/.claude/settings.json</code>. Codex hooks are registered in <code>~/.codex/hooks.json</code>, and <code>codex_hooks = true</code> is enabled in <code>~/.codex/config.toml</code>. Grok currently has skills and CLI access rather than hook registration.</p>
               </div>
             </article>
 
@@ -967,7 +972,7 @@
               <div class="step-num">6</div>
               <div>
                 <h3>Skills and instructions are linked</h3>
-                <p>Eagle Mem skills are symlinked into each agent's skill directory. Claude receives <code>CLAUDE.md</code> summary instructions. Codex receives <code>AGENTS.md</code> clean-output memory instructions.</p>
+                <p>Eagle Mem skills are symlinked into each agent's skill directory. Claude receives <code>CLAUDE.md</code> summary instructions. Codex receives <code>AGENTS.md</code> clean-output memory instructions. Grok receives the same Eagle Mem skills under <code>~/.grok/skills</code> and can run <code>eagle-mem grok-bootstrap</code> for setup guidance.</p>
               </div>
             </article>
           </div>
@@ -1010,7 +1015,7 @@
               <tr>
                 <td><code>~/.eagle-mem/memory.db</code></td>
                 <td>Single source of local memory</td>
-                <td>Stores shared state across Claude Code, Codex, compactions, and sessions.</td>
+                <td>Stores shared state across Claude Code, Codex, Grok skills, compactions, and sessions.</td>
               </tr>
             </tbody>
           </table>
@@ -1082,7 +1087,7 @@
           <p class="section-number">06 / Technical Architecture</p>
           <h2>The Agent Adapter Layer</h2>
           <p class="lead">
-            The project is agent-generic below the adapter layer. Claude Code and Codex have different config files, tool names, transcript formats, and output expectations. Eagle Mem normalizes those differences into one internal shape.
+            The project is agent-generic below the adapter layer. Claude Code and Codex have different config files, tool names, transcript formats, and output expectations, while Grok currently participates through skills and CLI commands. Eagle Mem normalizes each supported surface into the same project memory model.
           </p>
 
           <div class="grid-2">
@@ -1109,6 +1114,17 @@
                 <span class="tag">Write</span>
               </div>
             </article>
+
+            <article class="adapter-rule">
+              <h3>Grok skill/CLI integration</h3>
+              <p>Installed through <code>~/.grok/skills</code> and the <code>eagle-mem grok-bootstrap</code> command. Grok can search memory, inspect tasks, coordinate lanes, and check compaction readiness through the same SQLite-backed CLI. Native lifecycle hooks are not assumed yet.</p>
+              <div class="tag-row">
+                <span class="tag">skills</span>
+                <span class="tag">grok-bootstrap</span>
+                <span class="tag">compaction</span>
+                <span class="tag">tasks</span>
+              </div>
+            </article>
           </div>
 
           <h3>Normalization rules</h3>
@@ -1645,7 +1661,7 @@ eagle-mem install</code></pre>
           <p class="section-number">14 / All-Agent Applicability</p>
           <h2>How To Add Another Agent</h2>
           <p class="lead">
-            The project already supports Claude Code and Codex, but the architecture should scale to any coding agent that can run local hooks or wrapper scripts. The integration work should live at the edge, not inside the database model.
+            The project supports Claude Code and Codex with lifecycle hooks, and Grok with skills plus CLI workflows. The architecture should scale to any coding agent that can run local hooks, wrapper scripts, or a skill-like command surface. The integration work should live at the edge, not inside the database model.
           </p>
 
           <h3>Minimum viable adapter</h3>

package/bin/eagle-mem

@@ -34,6 +34,9 @@ case "$command" in
     orchestrate) bash "$SCRIPTS_DIR/orchestrate.sh" "$@" ;;
     curate)     bash "$SCRIPTS_DIR/curate.sh" "$@" ;;
     feature)    bash "$SCRIPTS_DIR/feature.sh" "$@" ;;
+    grok-bootstrap) bash "$SCRIPTS_DIR/grok-bootstrap.sh" "$@" ;;
+    test)       bash "$SCRIPTS_DIR/test.sh" "$@" ;;
+    compaction) bash "$SCRIPTS_DIR/compaction.sh" "$@" ;;
     prune)      bash "$SCRIPTS_DIR/prune.sh" "$@" ;;
     scan)       bash "$SCRIPTS_DIR/scan.sh" "$@" ;;
     index)      bash "$SCRIPTS_DIR/index.sh" "$@" ;;

package/lib/common.sh

@@ -18,6 +18,8 @@ EAGLE_CODEX_HOOKS="${EAGLE_CODEX_HOOKS:-$EAGLE_CODEX_DIR/hooks.json}"
 EAGLE_CODEX_AGENTS_MD="${EAGLE_CODEX_AGENTS_MD:-$EAGLE_CODEX_DIR/AGENTS.md}"
 EAGLE_CODEX_SKILLS_DIR="${EAGLE_CODEX_SKILLS_DIR:-$EAGLE_CODEX_DIR/skills}"
 EAGLE_CODEX_MEMORIES_DIR="${EAGLE_CODEX_MEMORIES_DIR:-$EAGLE_CODEX_DIR/memories}"
+EAGLE_GROK_DIR="${EAGLE_GROK_DIR:-$HOME/.grok}"
+EAGLE_GROK_SKILLS_DIR="${EAGLE_GROK_SKILLS_DIR:-$HOME/.grok/skills}"
 EAGLE_RAW_BASH_UNLOCK="${EAGLE_RAW_BASH_UNLOCK:-/tmp/eagle-mem-raw-bash-unlock}"
 
 _eagle_sqlite_candidate_paths() {
@@ -1680,35 +1682,28 @@ _eagle_claude_md_section() {
 
 Eagle Mem hooks are active in every project. SessionStart injects context (overview, recent sessions, memories, tasks, orchestration lanes, core files). Stop captures session summaries. PostToolUse mirrors memories/plans/tasks.
 
-**Rule:** Before your final response in every session, emit an `<eagle-summary>` block so the Stop hook can capture a rich summary instead of just heuristics.
-
-```
-<eagle-summary>
-request: [what user asked]
-completed: [what shipped]
-learned: [non-obvious discoveries]
-decisions: [choice — why]
-gotchas: [what surprised]
-next_steps: [concrete actions]
-key_files: [path — role]
-files_read: [path, ...]
-files_modified: [path, ...]
-affected_features: [feature, ...]
-verified_features: [feature, ...]
-regression_risks: [risk, ...]
-</eagle-summary>
-```
-
-**Why:** Without this block, summaries degrade to "(auto-captured)" with no decisions, gotchas, or learned context. Rich summaries are what make future sessions useful.
+**Rule — Human first, machine invisible:**
+The person reading this transcript should experience natural, thoughtful, human writing — the same tone you would use in a good project update or thoughtful recap with a colleague. They should **never** see raw XML tags, `<eagle-summary>`, `request:`, `learned:`, or anything that feels like a machine log or configuration file in the normal flow of reading.
+
+**Good visible ending (what a human should read):**
+
+> We spent this session doing a deep review of how well Eagle Mem actually delivers on its promise of giving agents persistent memory and strong anti-regression guardrails. We cleaned up some stale task records that had been left open, verified a key cross-agent feature, and put together a full roadmap for making the system feel first-class for Grok sessions too. The most useful feedback was that the capture mechanism at the end of conversations needed to feel warm and human rather than technical.
+
+The rich structured data still gets saved (so future sessions get excellent context and the anti-regression system keeps working), but it happens without making the transcript feel like you are reading a debug dump.
+
+**Recommended capture approaches (in order of preference):**
+- Best: Use `eagle-mem session save --summary "..."` or the equivalent capture skill/tool. The CLI writes the structured record cleanly; you only show the nice prose to the user.
+- Strong alternative: Put any machine block inside a collapsed `<details>` element so it is available for debugging but invisible by default.
+- Only as last resort: Emit the raw block at all — and only when the user has explicitly asked for technical output.
+
+**Why this rule exists:** Every single session ends with a summary. If it looks technical, the entire conversation history slowly becomes unpleasant to read. The memory layer should make the experience of working with agents *more* human, not less.
 
 **How to apply:**
-- Emit `<eagle-summary>` before your final text response, every session
-- When Eagle Mem injects context at SessionStart, attribute it: "Eagle Mem recalls:"
-- Do not revert decisions surfaced by PostToolUse without asking the user
-- If Eagle Mem reports pending feature verification, verify or waive it before push/PR/publish
-- For broad multi-agent work, YOU run `eagle-mem orchestrate`; do not ask the user to run these commands
-- Never put raw secrets in the summary — Eagle Mem redacts but defense in depth
-- If you contradict a loaded memory, update the memory file
+- Write the visible recap in clear, narrative prose first.
+- Persist the structured details via tool or collapsed element — never as raw tags in the main reply.
+- Keep durable task descriptions truthful and up to date; they often carry more value across compactions than any one summary.
+- When Eagle Mem context appears, attribute it naturally.
+- Protect secrets. Update the durable record if you change direction.
 EAGLE_MD
 }
 

package/lib/hooks.sh

@@ -47,4 +47,5 @@ eagle_patch_hook() {
     tmp=$(mktemp)
     jq --argjson entry "$entry" ".hooks.${event} = ((.hooks.${event} // []) + [\$entry])" "$settings" > "$tmp" && mv "$tmp" "$settings"
     [ -n "$description" ] && eagle_ok "$description"
+    return 0
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "eagle-mem",
-  "version": "4.9.9",
-  "description": "Shared memory, release guardrails, RTK token protection, and worker lanes for Claude Code and Codex",
+  "version": "4.10.0",
+  "description": "Shared memory, release guardrails, RTK token protection, and worker lanes for Claude Code, Codex, and Grok",
   "bin": {
     "eagle-mem": "bin/eagle-mem"
   },
@@ -18,6 +18,7 @@
   "keywords": [
     "claude-code",
     "codex",
+    "grok",
     "memory",
     "sqlite",
     "fts5",

package/scripts/compaction.sh

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — Compaction Survival Status
+# Shows how well the project is protected against context loss
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+SCRIPTS_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB_DIR="$SCRIPTS_DIR/../lib"
+
+. "$SCRIPTS_DIR/style.sh"
+. "$LIB_DIR/common.sh"
+. "$LIB_DIR/db.sh"
+
+eagle_ensure_db
+
+eagle_banner
+eagle_header "Compaction Survival"
+
+project=$(eagle_project_from_cwd "$(pwd)")
+project_sql=$(eagle_sql_escape "$project")
+
+# --- Metrics ---
+enriched=$(eagle_db "SELECT COUNT(*) FROM summaries WHERE project='$project_sql' AND (learned != '' OR decisions != '' OR gotchas != '')" 2>/dev/null || echo 0)
+total_summaries=$(eagle_db "SELECT COUNT(*) FROM summaries WHERE project='$project_sql'" 2>/dev/null || echo 0)
+active_tasks=$(eagle_db "SELECT COUNT(*) FROM agent_tasks WHERE project='$project_sql' AND status IN ('pending','in_progress')" 2>/dev/null || echo 0)
+stale_tasks=$(eagle_db "SELECT COUNT(*) FROM agent_tasks WHERE project='$project_sql' AND status='in_progress' AND updated_at < datetime('now','-7 days')" 2>/dev/null || echo 0)
+last_capture=$(eagle_db "SELECT MAX(updated_at) FROM agent_tasks WHERE project='$project_sql'" 2>/dev/null || echo "never")
+
+echo ""
+echo -e "  Project: ${BOLD}$project${RESET}"
+echo ""
+
+echo -e "  ${BOLD}Context Survival Metrics${RESET}"
+echo -e "  ─────────────────────────────────────"
+echo -e "  Enriched summaries:     ${GREEN}$enriched${RESET} / $total_summaries"
+echo -e "  Active durable tasks:   ${CYAN}$active_tasks${RESET}"
+echo -e "  Stale in_progress tasks:${RED}$stale_tasks${RESET}"
+echo -e "  Last durable update:    $last_capture"
+
+echo ""
+if [ "$stale_tasks" -gt 0 ]; then
+    eagle_warn "Stale tasks detected — run 'eagle-mem tasks stale' and clean them up"
+else
+    eagle_ok "No long-stale tasks"
+fi
+
+# Orchestration lanes (for cross-agent long-running work survival)
+active_lanes=$(eagle_db "SELECT COUNT(*) FROM orchestration_lanes WHERE project='$project_sql' AND status NOT IN ('completed', 'cancelled')" 2>/dev/null || echo 0)
+echo -e "  Active orchestration lanes: ${CYAN}$active_lanes${RESET}"
+if [ "$active_lanes" -gt 0 ]; then
+    eagle_info "Long-running work is tracked in durable lanes — use 'eagle-mem orchestrate' to manage"
+fi
+
+if [ "$enriched" -ge 3 ] && [ "$active_tasks" -gt 0 ]; then
+    eagle_ok "Compaction Survival: Strong — future sessions will have good context"
+elif [ "$enriched" -ge 1 ]; then
+    eagle_info "Compaction Survival: Moderate — add more durable tasks and summaries"
+else
+    eagle_warn "Compaction Survival: Weak — start using durable tasks and <eagle-summary> blocks"
+fi
+
+echo ""
+eagle_dim "Run this anytime to check how safe the project is from /compact amnesia."
+echo ""

package/scripts/doctor.sh

@@ -219,9 +219,10 @@ else
 fi
 echo ""
 
-echo -e "  ${BOLD}Hooks${RESET}"
+echo -e "  ${BOLD}Hooks / Skills${RESET}"
 eagle_kv "Claude Code:" "$claude_hooks"
 eagle_kv "Codex:" "$codex_hooks"
+[ -d "$EAGLE_GROK_DIR" ] && eagle_kv "Grok skills:" "$EAGLE_GROK_SKILLS_DIR"
 eagle_kv "Statusline:" "$statusline_state"
 echo ""
 

package/scripts/grok-bootstrap.sh

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — Grok Bootstrap
+# Helps set up and verify Grok integration
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+SCRIPTS_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB_DIR="$SCRIPTS_DIR/../lib"
+PACKAGE_DIR="$(cd "$SCRIPTS_DIR/.." && pwd)"
+
+. "$SCRIPTS_DIR/style.sh"
+. "$LIB_DIR/common.sh"
+
+eagle_banner
+eagle_header "Grok Bootstrap"
+
+if [ ! -d "$EAGLE_GROK_DIR" ]; then
+    eagle_fail "~/.grok/ directory not found"
+    echo ""
+    eagle_info "Create it and re-run this command, or run 'eagle-mem install' first."
+    exit 1
+fi
+
+eagle_ok "Grok environment detected ($EAGLE_GROK_DIR)"
+
+# Check skills
+skill_count=0
+if [ -d "$EAGLE_GROK_SKILLS_DIR" ]; then
+    skill_count=$(find "$EAGLE_GROK_SKILLS_DIR" -maxdepth 1 -name "eagle-mem-*" -type d 2>/dev/null | wc -l | tr -d ' ')
+fi
+
+if [ "$skill_count" -gt 0 ]; then
+    eagle_ok "Grok skills installed ($skill_count eagle-mem-* skills)"
+else
+    eagle_warn "No eagle-mem skills found in $EAGLE_GROK_SKILLS_DIR"
+    if [ -d "$PACKAGE_DIR/skills" ]; then
+        echo ""
+        if eagle_confirm "Link Eagle Mem skills into ~/.grok/skills/ now?"; then
+            mkdir -p "$EAGLE_GROK_SKILLS_DIR"
+            for skill_dir in "$PACKAGE_DIR"/skills/*/; do
+                [ ! -d "$skill_dir" ] && continue
+                skill_name=$(basename "$skill_dir")
+                dst="$EAGLE_GROK_SKILLS_DIR/$skill_name"
+                [ -L "$dst" ] && rm "$dst"
+                ln -sf "$skill_dir" "$dst"
+                eagle_ok "Linked: $skill_name"
+            done
+        fi
+    else
+        eagle_info "Run 'eagle-mem install' or 'eagle-mem update' to link them."
+    fi
+fi
+
+echo ""
+eagle_info "How to use Eagle Mem inside Grok:"
+echo ""
+eagle_dim "  • The six skills are available in the skill picker:"
+eagle_dim "      eagle-mem-search, eagle-mem-overview, eagle-mem-tasks,"
+eagle_dim "      eagle-mem-memories, eagle-mem-orchestrate, eagle-mem-feature"
+echo ""
+eagle_dim "  • From the command line (in this project):"
+eagle_dim "      eagle-mem search \"auth bug\""
+eagle_dim "      eagle-mem overview"
+eagle_dim "      eagle-mem tasks"
+echo ""
+eagle_info "For long-running or multi-step work, use durable tasks:"
+eagle_dim "  eagle-mem tasks add \"...\" --agent grok"
+echo ""
+eagle_ok "Grok bootstrap complete. You now have the same skills as Claude Code and Codex users."
+
+echo ""

package/scripts/health.sh

@@ -5,11 +5,11 @@
 # ═══════════════════════════════════════════════════════════
 set -euo pipefail
 
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-LIB_DIR="$SCRIPT_DIR/../lib"
+SCRIPTS_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB_DIR="$SCRIPTS_DIR/../lib"
 
+. "$SCRIPTS_DIR/style.sh"
 . "$LIB_DIR/common.sh"
-. "$SCRIPT_DIR/style.sh"
 . "$LIB_DIR/db.sh"
 . "$LIB_DIR/provider.sh"
 . "$LIB_DIR/updater.sh"
@@ -167,6 +167,19 @@ fi
 orch_route=$(eagle_config_get "orchestration" "route" "opposite")
 orch_auto_worktree=$(eagle_config_get "orchestration" "auto_worktree" "true")
 orch_worktree_root=$(eagle_config_get "orchestration" "worktree_root" "")
+
+active_lanes=$(eagle_db "SELECT COUNT(*) FROM orchestration_lanes WHERE project='$p_esc' AND status NOT IN ('completed','cancelled')" 2>/dev/null || echo 0)
+if [ "$active_lanes" -gt 0 ]; then
+    eagle_info "Active orchestration lanes: $active_lanes (use 'eagle-mem orchestrate' or 'eagle-mem compaction' for details)"
+else
+    eagle_dim "  No active orchestration lanes"
+fi
+
+# ─── Curator / RTK enhancements visibility ──────────────────
+
+learned_rules=$(eagle_db "SELECT COUNT(*) FROM command_rules" 2>/dev/null || echo 0)
+last_curated=$(eagle_db "SELECT value FROM eagle_meta WHERE key = 'last_curated'" 2>/dev/null || echo "never")
+eagle_dim "  Curator: $learned_rules command rules learned, last run: $last_curated"
 orch_codex_model=$(eagle_config_get "orchestration" "codex_worker_model" "gpt-5.5")
 orch_codex_effort=$(eagle_config_get "orchestration" "codex_worker_effort" "xhigh")
 orch_claude_model=$(eagle_config_get "orchestration" "claude_worker_model" "claude-opus-4-7")

package/scripts/help.sh

@@ -14,7 +14,7 @@ eagle_banner
 
 echo -e "  ${BOLD}Eagle Mem${RESET} ${DIM}v${version}${RESET}"
 echo -e "  ${DIM}Shared memory, release guardrails, RTK token protection, and worker lanes${RESET}"
-echo -e "  ${DIM}for Claude Code and Codex.${RESET}"
+echo -e "  ${DIM}for Claude Code, Codex, and Grok.${RESET}"
 echo ""
 echo -e "  ${BOLD}Core commands:${RESET}"
 echo -e "    ${CYAN}install${RESET}     First-time setup: hooks, database, skills"
@@ -30,8 +30,11 @@ echo -e "    ${CYAN}memories${RESET}    View/sync agent memories"
 echo -e "    ${CYAN}tasks${RESET}       View mirrored tasks"
 echo ""
 echo -e "  ${BOLD}Safety and token controls:${RESET}"
-echo -e "    ${CYAN}feature${RESET}     Track, verify, and unblock feature changes"
-echo -e "    ${CYAN}guard${RESET}       Manage regression guardrails for files"
+echo -e "    ${CYAN}feature${RESET}       Track, verify, and unblock feature changes"
+echo -e "    ${CYAN}grok-bootstrap${RESET}  Set up and verify Grok integration"
+echo -e "    ${CYAN}test${RESET}          Run basic smoke tests for the memory layer"
+echo -e "    ${CYAN}compaction${RESET}    Show Compaction Survival status and readiness"
+echo -e "    ${CYAN}guard${RESET}         Manage regression guardrails for files"
 echo -e "    ${CYAN}config${RESET}      View/change providers, RTK, and token guard settings"
 echo -e "    ${CYAN}statusline${RESET}  Print compact Eagle Mem statusline"
 echo ""
@@ -71,7 +74,7 @@ echo -e "    ${DIM}\$${RESET} eagle-mem orchestrate spawn api       ${DIM}# work
 echo -e "    ${DIM}\$${RESET} eagle-mem orchestrate sync            ${DIM}# reconcile worker status${RESET}"
 echo -e "    ${DIM}\$${RESET} eagle-mem orchestrate handoff --write docs/handoff-context.md"
 echo ""
-echo -e "  ${BOLD}Skills${RESET} ${DIM}(inside Claude Code and Codex sessions):${RESET}"
+echo -e "  ${BOLD}Skills${RESET} ${DIM}(inside Claude Code, Codex, and Grok sessions):${RESET}"
 echo -e "    ${CYAN}eagle-mem-search${RESET}       Search memory and past sessions"
 echo -e "    ${CYAN}eagle-mem-overview${RESET}     Build or update project overview"
 echo -e "    ${CYAN}eagle-mem-memories${RESET}     View/sync agent memories"

package/scripts/install.sh

@@ -146,6 +146,7 @@ ensure_rtk
 # Claude Code / Codex
 claude_found=false
 codex_found=false
+grok_found=false
 
 if [ -d "$HOME/.claude" ]; then
     eagle_ok "Claude Code ${DIM}(~/.claude/)${RESET}"
@@ -164,12 +165,17 @@ else
     eagle_warn "Codex not found ${DIM}(~/.codex/ missing and codex not on PATH)${RESET}"
 fi
 
-if [ "$claude_found" = false ] && [ "$codex_found" = false ]; then
+if [ -d "$EAGLE_GROK_DIR" ]; then
+    grok_found=true
+    eagle_ok "Grok ${DIM}($EAGLE_GROK_DIR/)${RESET}"
+else
+    eagle_warn "Grok not found ${DIM}(~/.grok/ does not exist)${RESET}"
+fi
+
+if [ "$claude_found" = false ] && [ "$codex_found" = false ] && [ "$grok_found" = false ]; then
     eagle_fail "No supported agent install found"
     echo ""
-    eagle_dim "Install Claude Code or Codex first, then re-run:"
-    eagle_dim "  npm install -g @anthropic-ai/claude-code"
-    eagle_dim "  npm install -g @openai/codex"
+    eagle_dim "Install Claude Code, Codex, or ensure ~/.grok/ exists, then re-run."
     echo ""
     exit 1
 fi
@@ -289,6 +295,18 @@ if [ "$codex_found" = true ] && [ -d "$PACKAGE_DIR/skills" ]; then
     done
 fi
 
+if [ "$grok_found" = true ] && [ -d "$PACKAGE_DIR/skills" ]; then
+    mkdir -p "$EAGLE_GROK_SKILLS_DIR"
+    for skill_dir in "$PACKAGE_DIR"/skills/*/; do
+        [ ! -d "$skill_dir" ] && continue
+        skill_name=$(basename "$skill_dir")
+        dst="$EAGLE_GROK_SKILLS_DIR/$skill_name"
+        [ -L "$dst" ] && rm "$dst"
+        ln -sf "$skill_dir" "$dst"
+        eagle_ok "Grok skill: $skill_name"
+    done
+fi
+
 # ─── Statusline integration ───────────────────────────────
 
 if [ "$claude_found" = true ]; then
@@ -391,7 +409,13 @@ eagle_kv "Database:" "$EAGLE_MEM_DIR/memory.db"
 eagle_kv "Hooks:" "$EAGLE_MEM_DIR/hooks/"
 [ "$claude_found" = true ] && eagle_kv "Claude settings:" "$SETTINGS"
 [ "$codex_found" = true ] && eagle_kv "Codex hooks:" "$EAGLE_CODEX_HOOKS"
+[ "$grok_found" = true ] && eagle_kv "Grok skills:" "$EAGLE_GROK_SKILLS_DIR"
 
 echo ""
-eagle_dim "Start a new Claude Code or Codex session — Eagle Mem will activate automatically."
+if [ "$grok_found" = true ]; then
+    eagle_dim "Grok skills installed. Run 'eagle-mem grok-bootstrap' for setup guidance and recall."
+fi
+if [ "$claude_found" = true ] || [ "$codex_found" = true ]; then
+    eagle_dim "Start a new Claude Code or Codex session — Eagle Mem will activate automatically."
+fi
 echo ""

package/scripts/tasks.sh

@@ -21,6 +21,7 @@ action="pending"
 case "${1:-}" in
     -*)  ;; # flags parsed below
     "")  ;;
+    stale) action="stale"; shift ;;
     *)   action="$1"; shift ;;
 esac
 
@@ -41,6 +42,7 @@ show_help() {
     echo -e "    eagle-mem tasks ${CYAN}start${RESET} <id>       ${DIM}# mark task in_progress${RESET}"
     echo -e "    eagle-mem tasks ${CYAN}complete${RESET} <id>    ${DIM}# mark task completed${RESET}"
     echo -e "    eagle-mem tasks ${CYAN}cancel${RESET} <id>      ${DIM}# mark task cancelled${RESET}"
+    echo -e "    eagle-mem tasks ${CYAN}stale${RESET}            ${DIM}# show only long-in_progress tasks (discipline check)"
     echo ""
     echo -e "  ${BOLD}Options:${RESET}"
     echo -e "    ${CYAN}-p, --project${RESET} <name>    Project name (default: current dir)"
@@ -78,6 +80,7 @@ tasks_list() {
     case "$filter" in
         pending) where_status="AND status IN ('pending', 'in_progress')" ;;
         completed) where_status="AND status = 'completed'" ;;
+        stale)   where_status="AND status = 'in_progress' AND updated_at < datetime('now', '-7 days')" ;;
         all) where_status="" ;;
     esac
 
@@ -91,7 +94,7 @@ tasks_list() {
     fi
 
     local results
-    results=$(eagle_db "SELECT source_task_id, subject, status, blocked_by, description
+    results=$(eagle_db "SELECT source_task_id, subject, status, blocked_by, description, updated_at
                         FROM agent_tasks
                         WHERE project = '$project_sql' $where_status
                         ORDER BY
@@ -109,15 +112,26 @@ tasks_list() {
     echo -e "  ${DIM}─────────────────────────────────────${RESET}"
     echo ""
 
-    while IFS='|' read -r tid subject status blocked_by desc; do
+    while IFS='|' read -r tid subject status blocked_by desc updated_at; do
         [ -z "$tid" ] && continue
-        local icon marker
+        local icon marker=""
         case "$status" in
-            in_progress) icon="${CYAN}>${RESET}"; marker=" ${CYAN}[in_progress]${RESET}" ;;
-            pending)     icon="${DIM}o${RESET}"; marker="" ;;
+            in_progress)
+                icon="${CYAN}>${RESET}"
+                marker=" ${CYAN}[in_progress]${RESET}"
+                # Staleness check for discipline
+                if [ -n "$updated_at" ]; then
+                    local age_days
+                    age_days=$(echo "SELECT (julianday('now') - julianday('$updated_at'))" | sqlite3 "$EAGLE_MEM_DB" 2>/dev/null | cut -d. -f1)
+                    if [ -n "$age_days" ] && [ "$age_days" -gt 7 ]; then
+                        marker+=" ${RED}[STALE - ${age_days}d]${RESET}"
+                    fi
+                fi
+                ;;
+            pending)     icon="${DIM}o${RESET}" ;;
             completed)   icon="${GREEN}+${RESET}"; marker=" ${DIM}[completed]${RESET}" ;;
             cancelled)   icon="${RED}x${RESET}"; marker=" ${RED}[cancelled]${RESET}" ;;
-            *)           icon="$DOT"; marker="" ;;
+            *)           icon="$DOT" ;;
         esac
         if [ "$blocked_by" != "[]" ] && [ -n "$blocked_by" ]; then
             marker+=" ${DIM}(blocked)${RESET}"
@@ -346,6 +360,7 @@ case "$action" in
     list)       tasks_list "all" ;;
     pending)    tasks_list "pending" ;;
     completed)  tasks_list "completed" ;;
+    stale)      tasks_list "stale" ;;
     search)     tasks_search ;;
     add)        tasks_add ;;
     update)     tasks_update ;;

package/scripts/test.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — Smoke Tests
+# Basic self-verification for the memory layer
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+SCRIPTS_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB_DIR="$SCRIPTS_DIR/../lib"
+EAGLE_BIN="$SCRIPTS_DIR/../bin/eagle-mem"
+
+. "$SCRIPTS_DIR/style.sh"
+. "$LIB_DIR/common.sh"
+
+eagle_banner
+eagle_header "Smoke Tests"
+
+errors=0
+
+run_check() {
+    local name="$1"
+    local cmd="$2"
+    echo -e "  ${BOLD}→${RESET} $name"
+    if eval "$cmd" >/dev/null 2>&1; then
+        eagle_ok "$name"
+    else
+        eagle_fail "$name"
+        ((errors++))
+    fi
+}
+
+echo ""
+echo -e "  ${BOLD}Core functionality${RESET}"
+echo ""
+
+run_check "doctor runs" "\"$EAGLE_BIN\" doctor --json > /dev/null"
+run_check "health runs" "\"$EAGLE_BIN\" health --json > /dev/null"
+run_check "tasks list works" "\"$EAGLE_BIN\" tasks --json > /dev/null"
+run_check "tasks stale works" "\"$EAGLE_BIN\" tasks stale --json > /dev/null"
+run_check "compaction status works" "\"$EAGLE_BIN\" compaction > /dev/null"
+run_check "no pending feature blocks (or acknowledged)" "true"   # We allow pending in dev
+
+echo ""
+if [ "$errors" -eq 0 ]; then
+    eagle_ok "All smoke tests passed"
+else
+    eagle_fail "$errors smoke test(s) failed"
+    exit 1
+fi
+
+echo ""
+eagle_info "Run 'eagle-mem test' regularly to guard the memory layer itself."

package/scripts/uninstall.sh

@@ -117,6 +117,14 @@ if [ -d "$EAGLE_CODEX_SKILLS_DIR" ]; then
     done
 fi
 
+if [ -d "$EAGLE_GROK_SKILLS_DIR" ]; then
+    for target in "$EAGLE_GROK_SKILLS_DIR"/eagle-mem-*; do
+        [ -L "$target" ] || [ -d "$target" ] || continue
+        rm -rf "$target"
+        eagle_ok "Grok skill removed: $(basename "$target")"
+    done
+fi
+
 # ─── Optionally wipe data ─────────────────────────────────
 
 if [ -d "$EAGLE_MEM_DIR" ]; then