Memory Agents

A Basic Memory Cloud agent is a note. Its frontmatter says type: agent, and its body is the instructions. Running it on another note (the target) starts a short-lived agent in Cloud that reads the target, works through the Basic Memory tools, and changes notes as its instructions say.

Agents run in Basic Memory Cloud only, on plans that include them. A local Basic Memory has no agent tools. Confirm the connected server exposes bm_agent before starting this workflow.

Project scope

If the project is unknown, discover it with bm_project(command="list"). Pass a nonempty project on every note, folder, context and schema call, even with one project or a qualified memory:// URL. Use the chosen project's name, workspace/project, or external ID; <project> below is a placeholder for it. Recent activity also requires project. Search accepts project for one project, projects for selected projects, or all_projects=True explicitly. Discovery and bundled manuals need no project. Keep the same scope when following returned paths, paginating, or recovering from a refusal.

When to Use

• The user wants recurring work on their notes done for them: follow up on meetings, link new notes, tidy a folder, write a weekly digest
• Asked to create, change, run, or turn off an agent
• Asked how an agent run went, what it changed, or why it did not run

Tools

Tool	Does
bm_agent(command="list", project="<project>")	The project's agents and how their recent runs went
bm_agent(command="run", project="<project>")	Starts an agent on a note; returns the run id
bm_agent(command="get", project="<project>")	One run: status, notes changed, and the agent's last reply
bm_agent(command="runs", project="<project>")	Recent runs, newest first, optionally for one agent
bm_agent(command="mark", project="<project>")	Mark a run kept or dismissed with run_id and decision