Basic Memory
Local

CLI basics

Common commands for projects, notes, and search.

The CLI is the fastest way to manage projects and run MCP tools directly from the terminal.

Use the short alias

bm is a short alias for basic-memory.

List and create projects

bm project list
bm project add "research" ~/Documents/research

Set the default project

bm project default "research"

Search notes

bm tools search-notes --query "authentication"

Read and write notes

bm tools read-note --path "docs/api-auth.md"

echo "New note content" | bm tools write-note --path "drafts/notes.md"

Next steps

CLI Reference

Complete command reference with all options.

MCP Tools (Local)

Learn how assistants use tools locally.