eagle-mem 4.7.0 → 4.8.0

package/scripts/config.sh

@@ -17,7 +17,32 @@ eagle_header "Config"
 subcommand="${1:-show}"
 shift 2>/dev/null || true
 
+show_help() {
+    echo -e "  ${BOLD}eagle-mem config${RESET} — Provider and token-guard settings"
+    echo ""
+    echo -e "  ${BOLD}Usage:${RESET}"
+    echo -e "    eagle-mem config                  ${DIM}# show current config${RESET}"
+    echo -e "    eagle-mem config ${CYAN}init${RESET}             ${DIM}# create config.toml${RESET}"
+    echo -e "    eagle-mem config ${CYAN}set${RESET} section.key value"
+    echo -e "    eagle-mem config ${CYAN}test${RESET}             ${DIM}# test curator provider${RESET}"
+    echo ""
+    echo -e "  ${BOLD}Examples:${RESET}"
+    echo -e "    eagle-mem config set provider.type agent_cli"
+    echo -e "    eagle-mem config set agent_cli.preferred current"
+    echo -e "    eagle-mem config set orchestration.route opposite"
+    echo -e "    eagle-mem config set orchestration.codex_worker_model gpt-5.5"
+    echo -e "    eagle-mem config set orchestration.claude_worker_model claude-opus-4-7"
+    echo -e "    eagle-mem config set token_guard.rtk enforce"
+    echo -e "    eagle-mem config set token_guard.raw_bash block"
+    echo ""
+    exit 0
+}
+
 case "$subcommand" in
+    --help|-h|help)
+        show_help
+        ;;
+
     init)
         eagle_config_init
         eagle_ok "Config created: $EAGLE_CONFIG_FILE"
@@ -36,8 +61,15 @@ case "$subcommand" in
             eagle_err "Usage: eagle-mem config set <section.key> <value>"
             eagle_info "Examples:"
             eagle_info "  eagle-mem config set provider.type ollama"
+            eagle_info "  eagle-mem config set provider.type agent_cli"
+            eagle_info "  eagle-mem config set agent_cli.preferred current"
+            eagle_info "  eagle-mem config set orchestration.route opposite"
+            eagle_info "  eagle-mem config set orchestration.codex_worker_effort xhigh"
+            eagle_info "  eagle-mem config set orchestration.claude_worker_effort xhigh"
             eagle_info "  eagle-mem config set ollama.model mistral"
             eagle_info "  eagle-mem config set anthropic.model claude-haiku-4-5-20251001"
+            eagle_info "  eagle-mem config set token_guard.rtk enforce"
+            eagle_info "  eagle-mem config set token_guard.raw_bash block"
             exit 1
         fi
         section="${key%%.*}"

package/scripts/health.sh

@@ -39,6 +39,8 @@ if [ -z "$project" ]; then
     exit 1
 fi
 
+eagle_ensure_db
+
 p_esc=$(eagle_sql_escape "$project")
 
 eagle_info "Project: ${BOLD}$project${RESET}"
@@ -133,7 +135,11 @@ max_score=$((max_score + 15))
 
 provider=$(eagle_config_get "provider" "type" "none")
 if [ "$provider" != "none" ]; then
-    model=$(eagle_config_get "$provider" "model" "default")
+    if [ "$provider" = "agent_cli" ]; then
+        model=$(_eagle_agent_cli_target)
+    else
+        model=$(eagle_config_get "$provider" "model" "default")
+    fi
     eagle_ok "Provider: ${provider} (${model})"
     score=$((score + 15))
 else
@@ -141,6 +147,50 @@ else
     issues+=("Configure a provider: eagle-mem config init")
 fi
 
+# ─── Token guard visibility (informational) ────────────────
+
+rtk_mode=$(eagle_config_get "token_guard" "rtk" "auto")
+raw_bash_mode=$(eagle_config_get "token_guard" "raw_bash" "block")
+rtk_bin=$(command -v rtk 2>/dev/null || true)
+if [ -n "$rtk_bin" ]; then
+    eagle_ok "Token guard: RTK $rtk_mode (${rtk_bin}), raw_bash=$raw_bash_mode"
+elif [ "$rtk_mode" = "enforce" ]; then
+    eagle_fail "Token guard: RTK enforce enabled, but rtk not found"
+    issues+=("Install RTK or run: eagle-mem config set token_guard.rtk auto")
+else
+    eagle_dim "  Token guard: RTK not found (mode: $rtk_mode, raw_bash: $raw_bash_mode)"
+fi
+
+# ─── Orchestration visibility (informational) ───────────────
+
+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" "")
+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")
+orch_claude_effort=$(eagle_config_get "orchestration" "claude_worker_effort" "xhigh")
+codex_bin=$(command -v codex 2>/dev/null || true)
+claude_bin=$(command -v claude 2>/dev/null || true)
+
+if [ -n "$codex_bin" ] && [ -n "$claude_bin" ]; then
+    eagle_ok "Orchestration: route=$orch_route, worktrees=$orch_auto_worktree, Codex + Claude workers available"
+elif [ -n "$codex_bin" ]; then
+    eagle_warn "Orchestration: Codex available, Claude CLI missing"
+    issues+=("Install or authenticate Claude Code CLI before spawning Claude worker lanes.")
+elif [ -n "$claude_bin" ]; then
+    eagle_warn "Orchestration: Claude available, Codex CLI missing"
+    issues+=("Install or authenticate Codex CLI before spawning Codex worker lanes.")
+else
+    eagle_warn "Orchestration: worker CLIs not found"
+    issues+=("Install/authenticate Codex and Claude Code CLIs before using eagle-mem orchestrate spawn.")
+fi
+
+eagle_dim "  Workers: codex=${orch_codex_model}/${orch_codex_effort}, claude-code=${orch_claude_model}/${orch_claude_effort}"
+if [ -n "$orch_worktree_root" ]; then
+    eagle_dim "  Worktree root: $orch_worktree_root"
+fi
+
 # ─── 5. Data quality (10 pts) ──────────────────────────
 
 max_score=$((max_score + 10))
@@ -228,11 +278,31 @@ if [ "$JSON_OUT" -eq 1 ]; then
         --argjson enriched_summaries "${enriched_summaries:-0}" \
         --argjson features "${feature_count:-0}" \
         --arg provider "$provider" \
+        --arg token_guard_rtk "$rtk_mode" \
+        --arg token_guard_raw_bash "$raw_bash_mode" \
+        --arg rtk_bin "${rtk_bin:-}" \
+        --arg orchestration_route "$orch_route" \
+        --arg orchestration_auto_worktree "$orch_auto_worktree" \
+        --arg orchestration_worktree_root "$orch_worktree_root" \
+        --arg codex_worker_model "$orch_codex_model" \
+        --arg codex_worker_effort "$orch_codex_effort" \
+        --arg claude_worker_model "$orch_claude_model" \
+        --arg claude_worker_effort "$orch_claude_effort" \
+        --arg codex_bin "${codex_bin:-}" \
+        --arg claude_bin "${claude_bin:-}" \
         --argjson noise_pct "$noise_pct" \
         --arg last_curated "${last_curated:-never}" \
         '{project:$project, score:$score, max:$max_score, pct:$pct, grade:$grade,
           capture:{sessions:$total_sessions, summaries:$total_summaries, heuristic:$heuristic_summaries},
           enrichment:$enriched_summaries,
           features:$features, provider:$provider,
+          token_guard:{rtk:$token_guard_rtk, raw_bash:$token_guard_raw_bash, rtk_bin:$rtk_bin},
+          orchestration:{
+            route:$orchestration_route,
+            auto_worktree:$orchestration_auto_worktree,
+            worktree_root:$orchestration_worktree_root,
+            codex:{model:$codex_worker_model, effort:$codex_worker_effort, cli:$codex_bin},
+            claude_code:{model:$claude_worker_model, effort:$claude_worker_effort, cli:$claude_bin}
+          },
           noise_pct:$noise_pct, last_curated:$last_curated}' >&3
 fi

package/scripts/help.sh

@@ -21,11 +21,12 @@ echo -e "    ${CYAN}update${RESET}      Re-deploy hooks and run migrations"
 echo -e "    ${CYAN}uninstall${RESET}   Remove hooks and optionally delete data"
 echo -e "    ${CYAN}search${RESET}      Search past sessions, memories, and code"
 echo -e "    ${CYAN}health${RESET}      Diagnose pipeline health and background automation"
-echo -e "    ${CYAN}config${RESET}      View or change LLM provider settings"
+echo -e "    ${CYAN}config${RESET}      View or change provider and token-guard settings"
 echo -e "    ${CYAN}guard${RESET}       Manage regression guardrails for files"
 echo -e "    ${CYAN}overview${RESET}    Build or view project overview"
-echo -e "    ${CYAN}memories${RESET}    View/sync Claude Code memories"
+echo -e "    ${CYAN}memories${RESET}    View/sync agent memories"
 echo -e "    ${CYAN}tasks${RESET}       View mirrored tasks"
+echo -e "    ${CYAN}orchestrate${RESET} Durable worker-lane coordination"
 echo -e "    ${CYAN}curate${RESET}      Run curator (co-edits, hot files, guardrails)"
 echo -e "    ${CYAN}feature${RESET}     Track, verify, and unblock features"
 echo -e "    ${CYAN}prune${RESET}       Clean old sessions and stale data"
@@ -44,11 +45,21 @@ echo -e "    ${DIM}\$${RESET} eagle-mem feature pending       ${DIM}# pending re
 echo -e "    ${DIM}\$${RESET} eagle-mem feature verify NAME   ${DIM}# verify current diff after testing${RESET}"
 echo -e "    ${DIM}\$${RESET} eagle-mem feature waive ID      ${DIM}# intentional exception${RESET}"
 echo ""
-echo -e "  ${BOLD}Skills${RESET} ${DIM}(inside Claude Code 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 Claude Code memories"
-echo -e "    ${CYAN}/eagle-mem-tasks${RESET}       TaskAware Compact Loop for multi-step work"
+echo -e "  ${BOLD}Orchestration:${RESET}"
+echo -e "    ${DIM}Agent-run protocol for broad multi-lane work; users normally do not run this manually.${RESET}"
+echo -e "    ${DIM}Codex sessions spawn Claude workers; Claude sessions spawn Codex workers by default.${RESET}"
+echo -e "    ${DIM}\$${RESET} eagle-mem orchestrate init \"Ship release\""
+echo -e "    ${DIM}\$${RESET} eagle-mem orchestrate lane add api --agent codex --validate \"npm test\""
+echo -e "    ${DIM}\$${RESET} eagle-mem orchestrate spawn api       ${DIM}# worktree + worker process${RESET}"
+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 "    ${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"
+echo -e "    ${CYAN}eagle-mem-tasks${RESET}        TaskAware Compact Loop for multi-step work"
+echo -e "    ${CYAN}eagle-mem-orchestrate${RESET}  Orchestrator/worker lane handoffs"
 echo ""
 echo -e "  ${DIM}Everything else is automatic — scan, index, prune, and${RESET}"
 echo -e "  ${DIM}curator all run in the background via hooks.${RESET}"

package/scripts/install.sh

@@ -251,6 +251,18 @@ if [ "$claude_found" = true ] && [ -d "$PACKAGE_DIR/skills" ]; then
     done
 fi
 
+if [ "$codex_found" = true ] && [ -d "$PACKAGE_DIR/skills" ]; then
+    mkdir -p "$EAGLE_CODEX_SKILLS_DIR"
+    for skill_dir in "$PACKAGE_DIR"/skills/*/; do
+        [ ! -d "$skill_dir" ] && continue
+        skill_name=$(basename "$skill_dir")
+        dst="$EAGLE_CODEX_SKILLS_DIR/$skill_name"
+        [ -L "$dst" ] && rm "$dst"
+        ln -sf "$skill_dir" "$dst"
+        eagle_ok "Codex skill: $skill_name"
+    done
+fi
+
 # ─── Statusline integration ───────────────────────────────
 
 if [ "$claude_found" = true ]; then

package/scripts/memories.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # ═══════════════════════════════════════════════════════════
-# Eagle Mem — Claude Code Memory Mirror CLI
-# List, show, search, and sync Claude Code auto-memories
+# Eagle Mem — Agent Memory Mirror CLI
+# List, show, search, and sync mirrored memories/plans/tasks
 # ═══════════════════════════════════════════════════════════
 set -euo pipefail
 
@@ -28,7 +28,7 @@ limit=20
 query=""
 
 show_help() {
-    echo -e "  ${BOLD}eagle-mem memories${RESET} — Claude Code memory, plan & task mirror"
+    echo -e "  ${BOLD}eagle-mem memories${RESET} — Agent memory, plan & task mirror"
     echo ""
     echo -e "  ${BOLD}Usage:${RESET}"
     echo -e "    eagle-mem memories                          ${DIM}# list all mirrored memories${RESET}"
@@ -48,7 +48,7 @@ show_help() {
     echo -e "    ${CYAN}-l, --limit${RESET} <N>       Max results (default: 20)"
     echo ""
     echo -e "  ${BOLD}How it works:${RESET}"
-    echo -e "    ${DOT} Eagle Mem intercepts Claude Code's auto-memory, plan, and task writes"
+    echo -e "    ${DOT} Eagle Mem mirrors agent memory, plan, and task writes"
     echo -e "    ${DOT} All are mirrored into Eagle Mem's SQLite + FTS5"
     echo -e "    ${DOT} Use ${CYAN}sync${RESET} to backfill items written before mirroring was enabled"
     echo ""
@@ -92,12 +92,12 @@ memories_list() {
     eagle_header "Memories"
 
     local result
-    result=$(eagle_list_claude_memories "$project" "$limit")
+    result=$(eagle_list_agent_memories "$project" "$limit")
 
     if [ -z "$result" ]; then
         eagle_dim "No mirrored memories found."
         echo ""
-        eagle_dim "Memories are captured automatically when Claude Code writes to its auto-memory."
+        eagle_dim "Memories are captured automatically when supported agents write memory files."
         eagle_dim "Run 'eagle-mem memories sync' to backfill existing memories."
         echo ""
         return
@@ -137,7 +137,7 @@ memories_search() {
     echo ""
 
     local result
-    result=$(eagle_search_claude_memories "$query" "$project" "$limit")
+    result=$(eagle_search_agent_memories "$query" "$project" "$limit")
 
     if [ -z "$result" ]; then
         eagle_dim "No memories matching '$query'"
@@ -179,7 +179,7 @@ memories_show() {
 
     local meta
     meta=$(eagle_db "SELECT memory_name, memory_type, description, file_path, updated_at, origin_session_id, origin_agent
-                     FROM claude_memories WHERE file_path = '$(eagle_sql_escape "$query")';")
+                     FROM agent_memories WHERE file_path = '$(eagle_sql_escape "$query")';")
 
     if [ -z "$meta" ]; then
         eagle_err "Memory not found: $query"
@@ -216,12 +216,12 @@ plans_list() {
     eagle_header "Plans"
 
     local result
-    result=$(eagle_list_claude_plans "$project" "$limit")
+    result=$(eagle_list_agent_plans "$project" "$limit")
 
     if [ -z "$result" ]; then
         eagle_dim "No captured plans found."
         echo ""
-        eagle_dim "Plans are captured when Claude Code writes to ~/.claude/plans/"
+        eagle_dim "Plans are captured when supported agents write plan files."
         eagle_dim "Run 'eagle-mem memories sync' to backfill existing plans."
         echo ""
         return
@@ -255,7 +255,7 @@ plans_search() {
     echo ""
 
     local result
-    result=$(eagle_search_claude_plans "$query" "$project" "$limit")
+    result=$(eagle_search_agent_plans "$query" "$project" "$limit")
 
     if [ -z "$result" ]; then
         eagle_dim "No plans matching '$query'"
@@ -289,7 +289,7 @@ plans_show() {
 
     local meta
     meta=$(eagle_db "SELECT title, project, file_path, updated_at, origin_session_id, origin_agent
-                     FROM claude_plans WHERE file_path = '$(eagle_sql_escape "$query")';")
+                     FROM agent_plans WHERE file_path = '$(eagle_sql_escape "$query")';")
 
     if [ -z "$meta" ]; then
         eagle_err "Plan not found: $query"
@@ -320,15 +320,15 @@ plans_show() {
 }
 
 tasks_list() {
-    eagle_header "Claude Code Tasks"
+    eagle_header "Agent Tasks"
 
     local result
-    result=$(eagle_list_claude_tasks "$project" "$limit")
+    result=$(eagle_list_agent_tasks "$project" "$limit")
 
     if [ -z "$result" ]; then
         eagle_dim "No captured tasks found."
         echo ""
-        eagle_dim "Tasks are captured when Claude Code uses TaskCreate/TaskUpdate."
+        eagle_dim "Tasks are captured when supported agents use task lifecycle tools."
         eagle_dim "Run 'eagle-mem memories sync' to backfill existing tasks."
         echo ""
         return
@@ -366,7 +366,7 @@ tasks_search() {
     echo ""
 
     local result
-    result=$(eagle_search_claude_tasks "$query" "$project" "$limit")
+    result=$(eagle_search_agent_tasks "$query" "$project" "$limit")
 
     if [ -z "$result" ]; then
         eagle_dim "No tasks matching '$query'"
@@ -404,7 +404,7 @@ tasks_show() {
 
     local meta
     meta=$(eagle_db "SELECT subject, status, description, active_form, source_session_id, source_task_id, file_path, updated_at, origin_agent
-                     FROM claude_tasks WHERE file_path = '$(eagle_sql_escape "$query")';")
+                     FROM agent_tasks WHERE file_path = '$(eagle_sql_escape "$query")';")
 
     if [ -z "$meta" ]; then
         eagle_err "Task not found: $query"
@@ -442,7 +442,7 @@ memories_sync() {
     eagle_header "Memory, Plan & Task Sync"
 
     # ─── Sync memories ───────────────────────────────────
-    eagle_info "Scanning for Claude Code auto-memory files..."
+    eagle_info "Scanning for agent memory files..."
     echo ""
 
     local claude_mem_root="$EAGLE_CLAUDE_PROJECTS_DIR"
@@ -456,7 +456,7 @@ memories_sync() {
             [ "$base" = "MEMORY.md" ] && continue
 
             local existing_hash
-            existing_hash=$(eagle_db "SELECT content_hash FROM claude_memories WHERE file_path = '$(eagle_sql_escape "$memfile")';")
+            existing_hash=$(eagle_db "SELECT content_hash FROM agent_memories WHERE file_path = '$(eagle_sql_escape "$memfile")';")
             local new_hash
             new_hash=$(shasum -a 256 "$memfile" | awk '{print $1}')
 
@@ -465,17 +465,40 @@ memories_sync() {
                 continue
             fi
 
-            eagle_capture_claude_memory "$memfile" "" ""
+            eagle_capture_agent_memory "$memfile" "" ""
             mem_synced=$((mem_synced + 1))
             eagle_ok "Memory: $base"
         done < <(find "$claude_mem_root" -path "*/memory/*.md" -print0 2>/dev/null)
     fi
 
+    local codex_mem_root="$EAGLE_CODEX_MEMORIES_DIR"
+    if [ -d "$codex_mem_root" ]; then
+        local codex_project="$project"
+        [ -z "$codex_project" ] && codex_project=$(eagle_project_from_cwd "$(pwd)")
+        for memfile in "$codex_mem_root/MEMORY.md" "$codex_mem_root/memory_summary.md"; do
+            [ ! -f "$memfile" ] && continue
+
+            local existing_hash
+            existing_hash=$(eagle_db "SELECT content_hash FROM agent_memories WHERE file_path = '$(eagle_sql_escape "$memfile")';")
+            local new_hash
+            new_hash=$(shasum -a 256 "$memfile" | awk '{print $1}')
+
+            if [ "$existing_hash" = "$new_hash" ]; then
+                mem_skipped=$((mem_skipped + 1))
+                continue
+            fi
+
+            eagle_capture_agent_memory "$memfile" "" "$codex_project" "codex"
+            mem_synced=$((mem_synced + 1))
+            eagle_ok "Codex memory: $(basename "$memfile")"
+        done
+    fi
+
     eagle_kv "Memories:" "$mem_synced synced, $mem_skipped unchanged"
     echo ""
 
     # ─── Sync plans ──────────────────────────────────────
-    eagle_info "Scanning for Claude Code plan files..."
+    eagle_info "Scanning for agent plan files..."
     echo ""
 
     local plans_dir="$EAGLE_CLAUDE_PLANS_DIR"
@@ -487,7 +510,7 @@ memories_sync() {
             [ ! -f "$planfile" ] && continue
 
             local existing_hash
-            existing_hash=$(eagle_db "SELECT content_hash FROM claude_plans WHERE file_path = '$(eagle_sql_escape "$planfile")';")
+            existing_hash=$(eagle_db "SELECT content_hash FROM agent_plans WHERE file_path = '$(eagle_sql_escape "$planfile")';")
             local new_hash
             new_hash=$(shasum -a 256 "$planfile" | awk '{print $1}')
 
@@ -496,7 +519,7 @@ memories_sync() {
                 continue
             fi
 
-            eagle_capture_claude_plan "$planfile" "" ""
+            eagle_capture_agent_plan "$planfile" "" ""
             plan_synced=$((plan_synced + 1))
             local ptitle
             ptitle=$(awk '/^# /{print; exit}' "$planfile" | sed 's/^# //')
@@ -508,7 +531,7 @@ memories_sync() {
     echo ""
 
     # ─── Sync tasks ──────────────────────────────────────
-    eagle_info "Scanning for Claude Code task files..."
+    eagle_info "Scanning for agent task files..."
     echo ""
 
     local tasks_dir="$EAGLE_CLAUDE_TASKS_DIR"
@@ -528,7 +551,7 @@ memories_sync() {
                 [ ! -f "$taskfile" ] && continue
 
                 local existing_hash
-                existing_hash=$(eagle_db "SELECT content_hash FROM claude_tasks WHERE file_path = '$(eagle_sql_escape "$taskfile")';")
+                existing_hash=$(eagle_db "SELECT content_hash FROM agent_tasks WHERE file_path = '$(eagle_sql_escape "$taskfile")';")
                 local new_hash
                 new_hash=$(shasum -a 256 "$taskfile" | awk '{print $1}')
 
@@ -537,7 +560,7 @@ memories_sync() {
                     continue
                 fi
 
-                eagle_capture_claude_task "$taskfile" "$sid" "$task_project"
+                eagle_capture_agent_task "$taskfile" "$sid" "$task_project"
                 task_synced=$((task_synced + 1))
             done
         done
@@ -547,7 +570,7 @@ memories_sync() {
     echo ""
 
     # ─── Backfill project names ──────────────────────────
-    eagle_info "Resolving project names from Claude Code transcripts..."
+    eagle_info "Resolving project names from agent transcripts..."
 
     local backfilled
     backfilled=$(eagle_backfill_projects)