ver 0.9

echo-memory.plugin.src/commands/echo-save.md

@@ -7,16 +7,19 @@ Use the **echo-memory** skill to persist this to the ECHO vault:
 
 > $ARGUMENTS
 
-Follow the skill's write discipline exactly:
-1. **Route** via `references/routing-map.md` (the canonical map). If no path fits, capture to `inbox/captures/inbox.md`.
-2. **Search-first** for any new slug-addressed note (slug AND human title) before creating — merge/promote instead of duplicating.
-3. Write through the bundled client so the call is status-checked and idempotent:
+Prefer the one-call **`capture`** — it routes (via the entity index), derives the canonical path, stamps frontmatter, indexes, auto-links mentioned entities, and writes the Agent-Log line. Pick the `--kind` from the content (`person, company, concept, reference, meeting, project, area, semantic, episodic, working, skill, decision`); use `--inbox` only when the home is genuinely unknown. Write multi-line bodies to a file with the Write tool (cross-platform, no heredoc).
 
 ```bash
-ECHO="${CLAUDE_PLUGIN_ROOT}/skills/echo-memory/scripts/echo.sh"
-"$ECHO" append inbox/captures/inbox.md "- $(date +%F): <entry>"      # idempotent capture
-"$ECHO" put <routed/path>.md  <bodyfile>                              # create/overwrite (verifies)
-"$ECHO" patch <path>.md append heading "<H1::Sub>" <bodyfile>        # targeted append
+ECHO="${CLAUDE_PLUGIN_ROOT}/skills/echo-memory/scripts/echo.py"   # run with: python3 "$ECHO" ... (Windows: python / py -3)
+python3 "$ECHO" capture "<title>" <bodyfile> --kind <kind> [--aliases a,b] [--source p1,p2]
+python3 "$ECHO" capture "<title>" --inbox     # unknown home -> idempotent inbox line
 ```
 
-4. Write in third person about Jason; set `agent_written: true` + `source_notes`; never put `[[wikilinks]]` in frontmatter; `bump` `updated:` only on substantive changes.
+Drop to the low-level verbs only for shapes `capture` doesn't model (a project `## Status` replace, an ADR mirror, a daily-note edit):
+
+```bash
+python3 "$ECHO" put   <routed/path>.md <bodyfile>                       # create/overwrite (verifies)
+python3 "$ECHO" patch <path>.md append heading "<H1::Sub>" <bodyfile>   # targeted append
+```
+
+Write in third person about Jason; never put `[[wikilinks]]` in frontmatter. `capture` handles `agent_written`, `source_notes`, indexing, and linking for you; if you write by hand, `resolve "<title>"` first to avoid duplicates and `bump` `updated:` only on substantive changes.