amem
Use the `amem` command to initialize, append, search, list, and review daily snapshots for local assistant memory (`.amem`). Use this when the user asks things like "log this with amem", "search memor
SKILL.md.claude/skills/amem/SKILL.md
GitHubamem CLI Skill
Run amem to operate local memory stored in .amem.
Where to run
- Primary: run in the project directory the user is currently working on.
- Development fallback: use
/home/yuiseki/Workspaces/repos/amemwithcargo run -q -- ....
Pre-check
- Check command availability with
amem --help. - If not available, use this fallback:
cd /home/yuiseki/Workspaces/repos/amem
cargo run -q -- --help
Core commands
1. Initialize
amem init
- Creates the
.amemscaffold. - Idempotent and non-destructive for existing files.
2. Show active memory directory
amem which
amem which --json
3. Fast append
amem keep "Went for a walk in Tokyo"
amem keep "Meeting note" --kind inbox
amem keep "Retrospective note" --date 2026-02-21 --source assistant
4. Search
amem search Tokyo --top-k 5
amem remember Tokyo --top-k 5
amem search "tomorrow plan" --json
5. List entries
amem list
amem ls --kind activity --limit 20
amem list --path "activity/**" --date 2026-02-21
6. Today snapshot
amem today
amem today --date 2026-02-21
amem today --json
7. Structured capture (explicit)
amem capture --kind activity --text "Meeting in Shibuya"
amem capture --kind inbox --text "Article to read later"
8. Task context assembly
amem context --task "tomorrow travel plan"
amem context --task "weekly review" --json
9. Rebuild/search index
amem index
amem index --rebuild
10. Watch mode
amem watch
11. Codex bridge
amem codex
amem codex --prompt "organize today's priority tasks"
amem codex --resume-only
12. Gemini bridge
amem gemini
amem gemini --prompt "organize today's priority tasks"
amem gemini --resume-only
13. Claude bridge
amem claude
amem claude --prompt "organize today's priority tasks"
amem claude --resume-only
14. Copilot bridge
amem copilot
amem copilot --prompt "organize today's priority tasks"
amem copilot --resume-only
Global options
--memory-dir <path>: explicitly set the memory root (instead of default~/.amem).--json: prefer machine-readable JSON output.
Recommended workflow
- First run:
amem init - Daily logging:
amem keep "..." - Pre-work check:
amem today - Search as needed:
amem search ...(oramem remember ...) - Periodic refresh:
amem index
Troubleshooting
amem: command not found- Use
cargo run -q -- ...in/home/yuiseki/Workspaces/repos/amem.
- Use
- Search results are sparse
- Run
amem index --rebuild.
- Run
- Need a different memory root
- Add
--memory-dir <abs/path/to/.amem>.
- Add