Versatly · G9Pedro · Feb 15, 2026
diff --git a/content/docs/(cli)/advanced/wiki-links-entity-routing.mdx b/content/docs/(cli)/advanced/wiki-links-entity-routing.mdx
@@ -409,11 +409,12 @@ Move the file manually to the correct category directory. ClawVault uses directo
 
 **Solutions:**
 ```bash
-# Find and fix in bulk
-clawvault link --orphans --fix
+# Find orphaned links
+clawvault link --orphans
 
-# Use link replacement
-clawvault link --replace "old-entity" "new-entity"
+# Preview and re-run auto-linking after manual fixes
+clawvault link --all --dry-run
+clawvault link --all
 
 # Regenerate graph after fixes
 clawvault graph --refresh

diff --git a/content/docs/(cli)/changelog.mdx b/content/docs/(cli)/changelog.mdx
@@ -8,6 +8,20 @@ description: Release history for ClawVault — every version, every feature, eve
   Subscribe via RSS
 </a>
 
+## v2.5.1 — February 15, 2026
+
+Patch release focused on stability and polish after v2.5.0.
+
+### Improved
+- Reliability fixes across session lifecycle and hook integration paths.
+- Minor CLI UX refinements and output consistency improvements.
+
+### Fixed
+- Follow-up fixes for v2.5.0 project/injection workflows.
+- Documentation alignment with live CLI behavior and flags.
+
+---
+
 ## v2.5.0 — February 15, 2026
 
 Two headline features that change how agents interact with their vaults.

diff --git a/content/docs/(cli)/commands/clean-exit.mdx b/content/docs/(cli)/commands/clean-exit.mdx
@@ -0,0 +1,32 @@
+---
+title: "clean-exit"
+description: "Mark a session as cleanly exited by clearing the dirty death flag"
+---
+
+Use `clean-exit` when you want to explicitly mark the current session as a clean shutdown.
+
+## Usage
+
+```bash
+clawvault clean-exit [options]
+```
+
+## Options
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `-v, --vault <path>` | Vault path | Nearest vault |
+
+## Examples
+
+```bash
+# Mark current vault as cleanly exited
+clawvault clean-exit
+
+# Target a specific vault
+clawvault clean-exit -v ~/memory
+```
+
+## Details
+
+ClawVault uses a dirty-death marker to detect context death on startup. `clean-exit` clears that marker when a session exits intentionally, so the next `wake`/`recover` run does not report a false crash signal.
diff --git a/content/docs/(cli)/commands/graph.mdx b/content/docs/(cli)/commands/graph.mdx
@@ -136,7 +136,7 @@ Graph index is stored at `.clawvault/graph-index.json`:
 Get machine-readable graph data:
 
 ```bash
-clawvault graph --format json
+clawvault graph --json
 ```
 
 ```json
@@ -192,10 +192,10 @@ clawvault graph --format json
 
 ## Connected Components
 
-View graph connectivity structure:
+View graph connectivity structure from JSON output:
 
 ```bash
-clawvault graph --components
+clawvault graph --json
 ```
 
 ```
@@ -221,10 +221,10 @@ Large connected components indicate good knowledge integration. Small isolated c
 
 ## Orphan Node Analysis
 
-Find unconnected memories:
+Find broken and unresolved wiki-links (a common source of disconnected graph nodes):
 
 ```bash
-clawvault graph --orphans
+clawvault link --orphans
 ```
 
 ```
@@ -379,7 +379,7 @@ clawvault graph
 
 # Monthly orphan cleanup 
 clawvault link --orphans
-clawvault graph --orphans
+clawvault graph
 
 # Quarterly full rebuild
 clawvault graph --refresh

diff --git a/content/docs/(cli)/commands/meta.json b/content/docs/(cli)/commands/meta.json
@@ -11,18 +11,20 @@
     "doctor",
     "compat",
     "repair-session",
+    "clean-exit",
     "---Sessions---",
     "wake",
     "sleep",
     "checkpoint",
     "recover",
     "handoff",
+    "recap",
     "session-recap",
     "---Task Management---",
     "task",
+    "project",
     "kanban",
     "task-transitions",
-    "kanban",
     "backlog",
     "blocked",
     "---Memory---",
@@ -31,6 +33,7 @@
     "search-vsearch",
     "list-get",
     "context",
+    "inject",
     "template",
     "---Observation---",
     "observe",

diff --git a/content/docs/(cli)/commands/project.mdx b/content/docs/(cli)/commands/project.mdx
@@ -5,7 +5,7 @@ description: "Manage projects with metadata, team, tasks, and Kanban boards"
 
 The `project` command introduces a first-class project primitive to ClawVault. Projects are stored as markdown files with YAML frontmatter in `projects/` and link to tasks, team members, and clients.
 
-For a comprehensive guide to the project primitive — frontmatter schema, team management, and workflows — see [Primitives → Projects](/docs/primitives/projects).
+For a comprehensive guide to the project primitive — frontmatter schema, team management, and workflows — see [Primitives → Projects](/primitives/projects).
 
 ## Usage
 

diff --git a/content/docs/(cli)/commands/recap.mdx b/content/docs/(cli)/commands/recap.mdx
@@ -0,0 +1,43 @@
+---
+title: "recap"
+description: "Generate a concise session recap from recent handoffs"
+---
+
+The `recap` command summarizes recent session continuity data ("who I was") from handoffs.
+
+## Usage
+
+```bash
+clawvault recap [options]
+```
+
+## Options
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `-n, --handoff-limit <n>` | Number of recent handoffs to include | `3` |
+| `-v, --vault <path>` | Vault path | Nearest vault |
+| `--json` | Output as JSON | `false` |
+| `--markdown` | Output as Markdown | `true` |
+| `--brief` | Minimal output for token savings | `false` |
+
+## Examples
+
+```bash
+# Default markdown recap
+clawvault recap
+
+# Include more handoffs
+clawvault recap --handoff-limit 5
+
+# Compact output for prompt injection
+clawvault recap --brief
+
+# JSON output for automation
+clawvault recap --json
+```
+
+## Related
+
+- [`wake`](/commands/wake) for full startup flow (recover + recap + summary)
+- [`session-recap`](/commands/session-recap) for transcript-based recap from a specific OpenClaw session key
diff --git a/content/docs/(cli)/commands/remember-capture.mdx b/content/docs/(cli)/commands/remember-capture.mdx
@@ -61,19 +61,16 @@ clawvault remember project "User Dashboard Redesign" \
 
 ### Advanced Examples
 
-#### With Tags and Templates
+#### From a File
 ```bash
 clawvault remember decision "API Rate Limiting Strategy" \
- --content "Implement token bucket with Redis backend" \
- --tags "api,performance,redis" \
- --template decision
+ --file ./notes/rate-limit-decision.md
 ```
 
-#### Custom Categories
+#### From Stdin
 ```bash
-clawvault remember fact "Production Database Config" \
- --content "Host: prod-db.company.com, Port: 5432" \
- --category infrastructure
+echo "Host: prod-db.company.com, Port: 5432" | \
+ clawvault remember fact "Production Database Config" --stdin
 ```
 
 #### Wiki-Links in Content
@@ -226,8 +223,7 @@ clawvault capture "Schedule team retro meeting"
 ```bash
 # Store file content as memory
 clawvault remember fact "API Documentation" \
- --content "$(cat api-spec.md)" \
- --tags "api,docs"
+ --file ./api-spec.md
 ```
 
 ## Best Practices
@@ -260,11 +256,10 @@ clawvault remember project "Mobile App v2" \
  --content "Related to [[api-redesign-decision]] and [[react-native-preference]]. Targets Q2 launch."
 ```
 
-### Tag for Discovery
+### Use Descriptive Titles for Better Search
 ```bash
 clawvault remember lesson "Database Connection Pooling" \
- --content "PgBouncer reduced connection overhead by 60%" \
- --tags "database,performance,postgresql,optimization"
+ --content "PgBouncer reduced connection overhead by 60%. PostgreSQL latency dropped under load."
 ```
 
 ## Error Handling

diff --git a/content/docs/(cli)/commands/repair-session.mdx b/content/docs/(cli)/commands/repair-session.mdx
@@ -234,10 +234,11 @@ Returns structured data for automation:
 
 ### Batch Repair
 ```bash
-# Repair all corrupted sessions
-for session in $(clawvault repair-session --list --corrupted-only); do
- clawvault repair-session --session $session
-done
+# 1) List sessions and identify ones that need repair
+clawvault repair-session --list
+
+# 2) Repair specific sessions by ID
+clawvault repair-session --session <session-id> --agent <agent-id>
 ```
 
 <Callout>

diff --git a/content/docs/(cli)/commands/search-vsearch.mdx b/content/docs/(cli)/commands/search-vsearch.mdx
@@ -185,7 +185,7 @@ If your ClawVault is inside OpenClaw's `memory/` folder, both will work. If your
 
 ## qmd Integration
 
-Both search commands require [qmd](https://github.com/Versatly/qmd) for indexing:
+Both search commands require [qmd](https://github.com/tobi/qmd) for indexing:
 
 ### Installation
 ```bash
@@ -207,7 +207,7 @@ clawvault status
 qmd update && qmd embed
 
 # Rebuild index from scratch 
-qmd update --force && qmd embed --force
+qmd update && qmd embed
 ```
 
 ### Collection Setup
@@ -344,8 +344,7 @@ clawvault search "query" -c nonexistent
 ```bash
 # Good: Include searchable keywords
 clawvault remember lesson "PostgreSQL Connection Pooling with PgBouncer" \
- --content "Database performance issue solved with connection pooling" \
- --tags "postgresql,performance,database,pgbouncer"
+ --content "Database performance issue solved with connection pooling"
 
 # Less searchable: Vague titles
 clawvault remember lesson "Thing we learned" \

diff --git a/content/docs/(cli)/commands/store.mdx b/content/docs/(cli)/commands/store.mdx
@@ -25,7 +25,7 @@ clawvault store [options]
 | `--overwrite` | Overwrite if exists | false |
 | `--no-index` | Skip qmd index update | false (auto-updates) |
 | `--embed` | Also update qmd embeddings for vector search | false |
-| `-v, --vault <path>` | Vault path | Nearest vault |
+| `-v, --vault <path>` | Vault path | Find nearest |
 
 ### Available Categories
 

diff --git a/content/docs/(cli)/commands/task.mdx b/content/docs/(cli)/commands/task.mdx
@@ -5,7 +5,7 @@ description: "Manage tasks as markdown files in your vault"
 
 The `task` command lets you create, track, and complete work items stored in your vault's `tasks/` folder.
 
-For a comprehensive guide to the task primitive — frontmatter schema, transition logging, Kanban integration, and workflows — see [Primitives → Tasks](/docs/primitives/tasks).
+For a comprehensive guide to the task primitive — frontmatter schema, transition logging, Kanban integration, and workflows — see [Primitives → Tasks](/primitives/tasks).
 
 ## Usage