Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add basicmachines-co/basic-memory --skill memory-agents -a claude-code
Open on GitHub

What 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/Launch in the work project.
  • 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-code

2Manually: put the files in place

~/.claude/skills/memory-agents/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/memory-agents/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set23

The whole set →
memory-onboarding memory-onboarding — a Claude Code skill that blueprints a Basic Memory knowledge graph with schemas and folders. Runs when scattered notes or messy project files need structured organization. CX Codex +1 1,200installs memory-comark memory-comark adds charts, tables, task boards and live views to Basic Memory notes via ::bm-* Comark components. Helpful when a note reads better as a figure or board. CX Codex +1 342installs memory-quest memory-quest is a Claude Code skill that verifies an assistant’s connection to Basic Memory Cloud and records the final verification note for Mission 8. CX Codex +1 327installs memory-okf memory-okf — a skill for Claude Code that finds and fixes blockers to exporting a Basic Memory project as OKF v0.2. It runs before publishing, handing off a project, or checking an export bundle. CX Codex +1 305installs memory-doctor The memory-doctor Claude Code skill checks local Basic Memory projects and explains its findings. It runs when search misses or repeats notes, or a save seems to have gone missing. CX Codex +1 249installs bm-setup This Claude Code skill configures Basic Memory through a short interview. It starts when asked to set up Basic Memory or when /basic-memory:bm-setup is run. CX Codex +1 160installs bm-remember A skill for quick capture of thoughts, facts, or reminders into Basic Memory. Responds to /basic-memory:bm-remember or natural language like "remember that…" — saves text as-is, preserving your wording. CX Codex +1 155installs bm-status bm-status is a Claude Code skill that checks Basic Memory's current health and configuration, including CLI access, hook queues, and recent session checkpoints. CX Codex +1 154installs

Project sponsors

Companies that keep this analytics open