memory-agents — Claude Code skill: agents and installation
The memory-agents Claude Code skill creates, runs, and checks Basic Memory Cloud agents. Agents follow instructions on notes and can start when someone creates a note in watched paths.
AGPL-3.0 268 installs ★ 4,660 updated 2026-10-24
npx skills add basicmachines-co/basic-memory --skill memory-agents -a claude-codeWhat memory-agents does
The skill helps manage Basic Memory Cloud agents: create or edit their notes, run one against a note or folder, inspect its result, and mark a run as kept or dismissed. An agent reads its target and changes notes according to its instructions. Each change is stored as a version that can be reverted.
Basic Memory Cloud on a plan with agents is required, along with a connected server that exposes bm_agent_* tools. Local Basic Memory does not provide those tools. Calls involving notes, folders, or schemas need a project scope. A watch can start an agent when someone creates a note under selected paths, and the agent only changes notes within its own project.
What it helps with
- write an agent that follows instructions on project notes
- run an agent against a note or folder
- inspect a run's status and changed notes
- find out why an agent run was skipped
- mark an agent run as kept or dismissed
Example prompts for the agent
- Create an agent that turns meeting notes into linked task notes.
- Run Curator on
projects/Launchin theworkproject. - Show the latest agent run's status and the notes it changed.
How to install memory-agents
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-agents -a claude-code2Manually: put the files in place
~/.claude/skills/memory-agents/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/memory-agents/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-agents -a codex2Manually: put the files in place
.agents/skills/memory-agents/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-agents -a cursor2Manually: put the files in place
.cursor/skills/memory-agents/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install basicmachines-co/basic-memory skills/memory-agents2Manually: put the files in place
.github/skills/memory-agents/SKILL.md1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-agents -a gemini-cli2Platform CLI
gemini skills install https://github.com/basicmachines-co/basic-memory --path skills/memory-agentsManually: put the files in place
.devin/skills/memory-agents/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-agents -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about memory-agents
How do I install memory-agents in Claude Code?
Run npx skills add basicmachines-co/basic-memory --skill memory-agents -a claude-code. The skill file is placed at ~/.claude/skills/memory-agents/SKILL.md.
What does memory-agents do?
It helps create, run, and inspect Basic Memory Cloud agents. Agents follow their instructions on notes, and their edits are stored as versions.
What does memory-agents need to run?
It requires Basic Memory Cloud on a plan that includes agents and a connected server exposing the bm_agent_* tools. Local Basic Memory has no agent tools.