# Basic Memory Setup

Guide Basic Memory setup in Tau.

- Repository: https://github.com/basicmachines-co/basic-memory (4440 stars)
- Category: Testing
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add basicmachines-co/basic-memory --skill basic-memory-setup -g -a claude-code -y`
Codex: `npx skills add basicmachines-co/basic-memory --skill basic-memory-setup -g -a codex -y`
Cursor: `npx skills add basicmachines-co/basic-memory --skill basic-memory-setup -g -a cursor -y`
Gemini CLI: `npx skills add basicmachines-co/basic-memory --skill basic-memory-setup -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add basicmachines-co/basic-memory`

## Description

Guide Basic Memory setup in Tau. Use when a user wants to install or configure the Tau memory extension, choose a memory destination or capture policy, verify connectivity, or troubleshoot setup. Check compatibility and obtain approval before installation, configuration changes, or test writes.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Set up Basic Memory in Tau

Help the user choose where memory goes and what gets saved. Ask one decision at a
time. Set up Basic Memory's shared workflow: schema-backed checkpoints, tasks,
decisions, categorized observations, and verified relations that other agents can
find. Tau provides the lifecycle callbacks; it does not define a separate memory
system. Do not create projects, reorganize notes, change credentials, or install
packages as incidental setup work.

Tau preserves the server's `bm_*` tool names, including `bm_read`, `bm_write`,
`bm_search`, and `bm_project`. Other advertised tools receive a `bm_` prefix.
Use the names and argument schemas advertised by the active Tau runtime.

## 1. Inspect before changing anything

The rest: https://github.com/basicmachines-co/basic-memory/blob/HEAD/integrations/tau/skills/basic-memory-setup/SKILL.md