Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/02.whats-new/06.changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ In Basic Memory Cloud, every project opens as a [Wiki](/cloud/wiki), with an ove

In the core package, the MCP server moves to the 1.0 `bm_*` tools: twelve tools such as `bm_read`, `bm_write`, `bm_edit`, `bm_search`, and `bm_context`, plus an opt-in `bm_project_delete`, with typed refusals and a manual page for each. `bm doctor` becomes a read-only report on your real projects, with the command that fixes each problem, and a `memory-doctor` skill walks an agent through it. Fixes cover watching newly created projects, large vector deletions and interrupted migrations on SQLite, and a stale storage read that could roll a note back to an older version. FastAPI is upgraded past the v0.24.1 pin.

Breaking changes: the MCP tools are renamed and their arguments change, and with several projects, note and search tools need an explicit project. Read [Basic Memory 1.0](/whats-new/basic-memory-1-0) for the highlights and [Migrating to 1.0](/reference/migrating-to-1-0) before switching clients.
Breaking changes: the MCP tools are renamed and their arguments change; with several projects, note and search tools need an explicit project; and note formatting is removed (`format_on_save`, `formatter_command`, `formatters`, `formatter_timeout`, and `bm format`). Read [Basic Memory 1.0](/whats-new/basic-memory-1-0) for the highlights and [Migrating to 1.0](/reference/migrating-to-1-0) before switching clients.

---

Expand Down
8 changes: 0 additions & 8 deletions content/07.local/3.cli-basics.md
Original file line number Diff line number Diff line change
Expand Up @@ -105,14 +105,6 @@ bm schema diff person

Infer a schema from existing notes, validate notes against it, and detect drift — see the [Schema System](/concepts/schema-system) for concepts and the full workflow.

## Format files

```bash
bm format
bm format --project research
bm format notes/meeting.md
```

## Next steps

:::card-group
Expand Down
15 changes: 0 additions & 15 deletions content/11.reference/1.cli-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -197,21 +197,6 @@ bm update --check
Auto-update behavior is configurable — see [Configuration](/reference/configuration) for the `auto_update` and `update_check_interval` settings.
::

### `bm format`

Format files using configured formatters. Uses the `formatter_command` or `formatters` settings from your config. By default, formats all `.md`, `.json`, and `.canvas` files in the current project.

```bash
bm format # Format all files in current project
bm format --project research # Format files in specific project
bm format notes/meeting.md # Format a specific file
bm format notes/ # Format all files in a directory
```

| Flag | Description |
|------|-------------|
| `--project`, `-p` | Target a specific project |

---

## Shell-style read commands
Expand Down
28 changes: 0 additions & 28 deletions content/11.reference/6.configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -472,34 +472,6 @@ Timestamp of the last automatic update check. Managed automatically — you don'

---

## Formatter settings

### `format_on_save`

Automatically format notes when they are saved via `write_note` or `edit_note`. With no `formatter_command` configured, markdown is formatted by the built-in mdformat; setting a command (or the per-extension `formatters` map) overrides it with an external tool.

- Type: boolean
- Default: `false`
- Env: `BASIC_MEMORY_FORMAT_ON_SAVE`

### `formatter_command`

External command to use for formatting markdown files. The file path is substituted via a `{file}` placeholder — for example `npx prettier --write {file}`. A per-extension `formatters` map is also available for different tools per file type.

- Type: string | null
- Default: `null`
- Env: `BASIC_MEMORY_FORMATTER_COMMAND`

### `formatter_timeout`

Maximum time in seconds to wait for the formatter command to complete.

- Type: float
- Default: `5.0`
- Env: `BASIC_MEMORY_FORMATTER_TIMEOUT`

---

## Database settings

### `database_backend`
Expand Down
9 changes: 9 additions & 0 deletions content/11.reference/7.migrating-to-1-0.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,3 +83,12 @@ Use `bm_man(page="bm-search(3)")` or `bm man bm-search` for the installed refere
Re-run benchmark baselines after upgrading; historical results describe the tool
surface they were measured against and should not be relabeled as 1.0 results.

## Note formatting is removed

1.0 no longer formats notes when they are saved. The `format_on_save`, `formatter_command`,
`formatters`, and `formatter_timeout` settings, their `BASIC_MEMORY_*` environment variables,
and the `bm format` command are gone, along with the built-in mdformat formatter.

A `config.json` that still has these keys keeps loading; the keys are ignored. Delete them
when convenient. To keep notes formatted, run your formatter (for example Prettier) over the
project folder yourself, outside Basic Memory.
Loading