How do I install the Agent Mem skill?

Run npx skillmds@latest add lmaksym/agent-mem in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Agent Mem safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Agent Mem?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Agent Mem free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Agent Mem?

lmaksym (@lmaksym) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Agent Mem by lmaksym — Agent Skill

Name: Agent Mem
Author: lmaksym

Agent Mem

Persistent, git-backed memory across sessions. Use at session start (snapshot), after decisions/fixes/mistakes (remember/lesson), to checkpoint work (commit), before risky exploration (branch), or to check prior context (search).

lmaksym 4a17c83 6 files · 10.7 KB Updated Sep 17, 2026

File contents

agent-mem

Git-backed memory for coding sessions via the amem CLI.

If $ARGUMENTS is provided, run agent-mem $ARGUMENTS and show output.

When to Use (triggers)

Starting a session → amem snapshot Load context tree, pinned files, memory summary. Run amem init if no .context/ exists.

You chose between alternatives → amem remember --decision "chose X because Y"

You noticed a repeatable approach → amem remember --pattern "always do X before Y"

You did something wrong → amem remember --mistake "never do X"

You solved a problem after investigation → amem lesson "problem -> how you fixed it" Use the -> shorthand, or --problem/--resolution/--tags flags for richer entries.

You completed meaningful work → amem commit "what you did"

You're about to try something that might not work → amem branch name "purpose" Merge back with findings: amem merge name "outcome". Even failed branches are valuable.

You're about to make a decision that might have prior context → amem search "query"

Session is long, you've learned a lot → amem reflect Synthesizes patterns, lessons, stale entries from recent activity.

Quick Reference

amem snapshot                          # start of session
amem remember --decision "text"        # decision / --pattern / --mistake / --note
amem lesson "problem -> resolution"    # problem you solved
amem commit "message"                  # checkpoint progress
amem branch name "purpose"             # explore uncertain idea
amem merge name "outcome"              # merge back findings
amem search "query"                    # check prior context
amem read <path>                       # read specific file
amem write <path> --content "text"     # write specific file
amem pin <path> / amem unpin <path>    # manage pinned files (system/)
amem reflect                           # gather reflection input
amem compact [--dry-run|--hard]        # archive stale context
amem status / amem config / amem help  # info commands

Remember vs Lesson

Remember = one-liner facts: decisions, patterns, mistakes, notes. Lesson = problem + resolution pair. If you investigated and fixed something, it's a lesson.

References

Reflection & compaction
Branching & merging
Sub-agent patterns
Collaboration & sharing
Coexistence with CLAUDE.md

---name: agent-memdescription: Persistent, git-backed memory across sessions. Use at session start (snapshot), after decisions/fixes/mistakes (remember/lesson), to checkpoint work (commit), before risky exploration (branch), or to check prior context (search).---# agent-memGit-backed memory for coding sessions via the `amem` CLI.If `$ARGUMENTS` is provided, run `agent-mem $ARGUMENTS` and show output.## When to Use (triggers)**Starting a session →** `amem snapshot`Load context tree, pinned files, memory summary. Run `amem init` if no `.context/` exists.**You chose between alternatives →** `amem remember --decision "chose X because Y"`**You noticed a repeatable approach →** `amem remember --pattern "always do X before Y"`**You did something wrong →** `amem remember --mistake "never do X"`**You solved a problem after investigation →** `amem lesson "problem -> how you fixed it"`Use the `->` shorthand, or `--problem`/`--resolution`/`--tags` flags for richer entries.**You completed meaningful work →** `amem commit "what you did"`**You're about to try something that might not work →** `amem branch name "purpose"`Merge back with findings: `amem merge name "outcome"`. Even failed branches are valuable.**You're about to make a decision that might have prior context →** `amem search "query"`**Session is long, you've learned a lot →** `amem reflect`Synthesizes patterns, lessons, stale entries from recent activity.## Quick Reference```bashamem snapshot # start of sessionamem remember --decision "text" # decision / --pattern / --mistake / --noteamem lesson "problem -> resolution" # problem you solvedamem commit "message" # checkpoint progressamem branch name "purpose" # explore uncertain ideaamem merge name "outcome" # merge back findingsamem search "query" # check prior contextamem read <path> # read specific fileamem write <path> --content "text" # write specific fileamem pin <path> / amem unpin <path> # manage pinned files (system/)amem reflect # gather reflection inputamem compact [--dry-run|--hard] # archive stale contextamem status / amem config / amem help # info commands```## Remember vs Lesson**Remember** = one-liner facts: decisions, patterns, mistakes, notes.**Lesson** = problem + resolution pair. If you investigated and fixed something, it's a lesson.## References- [Reflection & compaction](references/reflection-compaction.md)- [Branching & merging](references/branching-merging.md)- [Sub-agent patterns](references/sub-agent-patterns.md)- [Collaboration & sharing](references/collaboration.md)- [Coexistence with CLAUDE.md](references/coexistence.md)

Frequently asked questions