Store a memory entry for future recall. Use this to persist important context, decisions, or findings.
Store a memory entry for future recall. Use this to persist important context, decisions, architectural findings, or patterns you discover during work.
| Flag | JSON Field | Required | Description |
|---|---|---|---|
--agent / -a | agentId | Yes | Your agent ID / session name |
--content / -c | content | Yes | Content to remember (or pipe via stdin) |
--content-file | — | No | Read content from a file path |
--category / -C | category | Yes | Category: pattern, decision, gotcha, fact, preference, relationship, user_preference |
--scope / -s | scope | Yes | Scope: agent or project |
--project / -p | projectPath | No | Project path (required for project scope) |
# Store a project-wide pattern
bash execute.sh --agent dev-1 --content "User prefers PDF delivery in Slack thread" --category user_preference --scope project --project /projects/app
# Content via stdin (for text with special characters)
echo "Jest mock resets are required between tests — don't forget" | bash execute.sh --agent dev-1 --category gotcha --scope project --project /projects/app
# Content from file
bash execute.sh --agent dev-1 --content-file /tmp/finding.txt --category decision --scope project --project /projects/app
bash execute.sh '{"agentId":"dev-1","content":"User prefers PDF delivery","category":"user_preference","scope":"project","projectPath":"/projects/app"}'
JSON confirmation that the memory entry was stored.