| name | evolver-status |
| description | Show Evolver health — evolution memory location & size, recent log, and whether the full engine is installed. Use when the user asks for "evolver status", "evolver health", or "check evolver". |
Evolver Status
Check the health and readiness of the Evolver persistent self-evolution memory plugin.
Execution Guide
When requested by the user, run the following diagnostic checks using shell/terminal commands and report the findings back to the user as a clean checklist:
-
Evolution memory — check if the local JSONL graph exists and print how many outcomes it holds:
F=~/.evolver/memory/evolution/memory_graph.jsonl
[ -f "$F" ] && echo "memory graph: $F ($(wc -l < "$F" | tr -d ' ') outcomes)" || echo "no local evolution memory yet (it appears after a session ends with changes in a git repo)"
-
This workspace's id — verify the forge-resistant workspace ID (scoping key):
R=$(git rev-parse --show-toplevel 2>/dev/null); [ -n "$R" ] && { [ -f "$R/.evolver/workspace-id" ] && echo "workspace-id: present" || echo "workspace-id: not yet created (made on first recorded outcome)"; } || echo "not a git repo — memory inactive here"
-
Recent activity — print the last few lines of the evolution log:
tail -n 5 ~/.evolver/logs/evolution.log 2>/dev/null || echo "no evolution log yet"
-
Full engine (optional) — check if the global @evomap/evolver CLI is installed:
command -v evolver >/dev/null 2>&1 && evolver --version 2>/dev/null | head -1 || echo "evolver CLI not installed — hooks still work standalone; 'npm i -g @evomap/evolver' unlocks full pipeline features"
-
Network connection (optional) — check whether a node has been registered locally but not yet claimed on the network:
C=~/.evomap/claim_url
[ -s "$C" ] && echo "not connected yet — claim this node by opening $(cat "$C") while signed in to evomap.ai (that is the only step; no id or secret to enter)" || echo "no pending claim (either not registered yet, or already connected)"
If the Proxy is reachable and evolver_status reports an HTTP 402 / insufficient credits, translate that for the user in plain language: the network features (searching/reusing genes & capsules) need credits — see https://evomap.ai/pricing — while local evolution memory keeps working exactly as before. When reporting connection state, keep it to plain "are you connected?" language: surface the claim link and the credits note as above; do not dump raw JSON or internal terms like node_secret, stake, or hub_rotate.
Finish with a single-line summary statement on the overall readiness of the self-evolution memory.
