Agent Memory Journal
Durable episodic memory for agents — file-based, inspectable, and easy to review. Use when an agent needs to keep a working journal of what happened, what ma...
Skill: Agent Memory Journal
Manage and retrieve long-term memory using a 3-tier structure (Hot, Warm, Cold).
Primary integration surface: the Python Journal API.
The CLI is a convenience layer for shell and cron workflows.
Tools
agent-memory-journal note <text>: Add episodic note.agent-memory-journal remember <text> --category <cat>: Add core memory.agent-memory-journal search --query <q>: Search memory.agent-memory-journal forget <id>: Supersede a memory.agent-memory-journal ingest: Run promotion and rebuild cycle.
Core Categories
decision: Strategic choices.constraint: Hard rules or limitations.gotcha: Lessons learned or bugs.preference: User or agent preferences.capability: New skills or tools.
Guidelines
- Episodic first: Use
notefor observations. - Explicit curation: Use
rememberfor facts that must persist. - Atomic pinning: Use
--pinnedfor items that MUST be in the configured hot file. - Verification: Run
doctorperiodically to ensure integrity.
Agent installation
See docs/agent_install.md for:
- workspace installation
- CLI symlink setup
- startup contract for agents
- hot promotion target override via
.memory/config.json
Related skills
- Downloads
- 957All time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v0.2.3
- License
- MIT-0
