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

description, argument-hint

description	argument-hint
Save to ECHO memory — route content to its canonical home (search-first, idempotent)	[what to remember]

Use the echo-memory skill to persist this to the ECHO vault:

$ARGUMENTS

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).

ECHO="${CLAUDE_PLUGIN_ROOT}/skills/echo-memory/scripts/echo.py"   # run with: python3 "$ECHO" ... (Windows: python / py -3)
[ -f "$ECHO" ] || ECHO=$(ls /sessions/*/mnt/.remote-plugins/*/skills/echo-memory/scripts/echo.py 2>/dev/null | head -1)   # CoWork sandbox fallback
python3 "$ECHO" capture "<title>" <bodyfile> --kind <kind> [--aliases a,b] [--source p1,p2]
python3 "$ECHO" capture "<title>" --inbox     # unknown home -> idempotent inbox line

Drop to the low-level verbs only for shapes capture doesn't model (a project ## Status replace, an ADR mirror, a daily-note edit):

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 the vault owner; 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.