---
schema: "https://insidethemachine.ai/schema/listing.schema.json"
slug: "basic-memory"
name: "Basic Memory"
kind: "repo"
tier: "catalog"
category: "memory"
category_label: "Memory"
stack_layer: "memory"
homepage: "https://basicmemory.com"
repo: "https://github.com/basicmachines-co/basic-memory"
license: "AGPL-3.0"
stars: 4231
last_push: "2026-10-14"
archived: false
tags: []
seen_in_videos: []
gap_score: null
gap_score_status: "pending test on Mac Studio"
verified_on: "2026-10-15"
---

# Basic Memory

**What:** Markdown-file memory your agent reads and writes.

**Why:** Lets your agent remember across sessions.

**Category:** Memory · **Stack layer:** memory

## Status

Catalog entry. Existence and repo metadata checked 2026-10-15 via the GitHub API. Install commands below are auto-extracted from the README and have NOT been executed or verified. Read the README before running anything; prefer a sandbox or venv.

## Install (unverified)

1. [any] source: README (auto-extracted); status: unverified, not executed

```bash
uv tool install basic-memory --prerelease=allow
```

2. [any] source: README (auto-extracted); status: unverified, not executed

```bash
uv tool install "basic-memory[milvus]" --prerelease=allow
```

## Verify

No verified check yet. Minimum: the install command exits 0 and the tool's own help/version flag runs (exact flag: see README).

## Rollback (unverified)

1. source: derived inverse of install command

```bash
uv tool uninstall basic-memory
```

## Links

- Homepage: https://basicmemory.com
- Repo: https://github.com/basicmachines-co/basic-memory
- README: https://github.com/basicmachines-co/basic-memory#readme