Skip to content

docs: v0.24.0 and v0.24.1 release documentation - #50

Merged
phernandez merged 9 commits into
mainfrom
docs/v0.24.0
Oct 23, 2026
Merged

phernandez merged 9 commits into
mainfrom
docs/v0.24.0

Conversation

@phernandez

@phernandez phernandez commented Oct 11, 2026 •

Copy link
Copy Markdown
Member

Summary

Docs for the Basic Memory v0.24.0 and v0.24.1 releases.

What's New

  • New pages: What's New in v0.24 and Upgrade to v0.24.
  • Changelog: v0.24 section, plus the v0.23.1/v0.23.2 patch notes that were missing.
  • Welcome callout points at v0.24.
  • Removed the v0.23, v0.23 upgrade, Hermes plugin, Cloud app updates, agent skills, OpenClaw plugin, and AI-friendly docs pages. Their URLs 301 to the changelog or the matching integration/reference page.

Reference

  • MCP tools:
    • The POSIX read tools (cat, grep, ls, find, tail, man) are now on by default.
    • Revision guards (expected_checksum), and refused writes are returned as isError.
    • Compact results and line reads.
    • Cross-project and valid-time search, plus the new metadata operators.
    • MCP resources and the built-in manual.
  • CLI and configuration:
    • New commands: bm cat/grep/ls/find/tail/tree, man, wiki, okf, prune, install, import document, project index.
    • Changed behavior: project remove, status --wait, and the HTTP transport now binds to loopback by default.
    • Retired settings: semantic_search_enabled, disable_permalinks.
  • Troubleshooting and Docker entries for the breaking changes.

Concepts

Cloud and integrations

  • bm cloud sync/bisync are deprecated in favor of push/pull.
  • Removing a cloud project now always deletes its cloud files.
  • Read-only and project-limited API keys.
  • bm install, new Tau and Pi pages, and updates to the Hermes, OpenClaw, and Codex pages.
  • Postgres now needs pgvector 0.8 or later.

Updates from the published v0.24.0/v0.24.1 changelog

  • v0.24.1 patch: FastAPI pinned to 0.139.0. Changelog entry, an "install v0.24.1 or later" note on the What's New and Upgrade pages, and a troubleshooting entry for the get_flat_dependant import error.
  • v0.24.0 security fixes: GHSA-4gfv-c2mm-mvj2 (high, DNS rebinding on the HTTP transports) and GHSA-pqm2-2wxw-p5hx (low). The changelog lists them, and What's New has a short section.
  • Changes that were missing:
    • read_content now returns only PNG, JPEG, and WebP images.
    • build_context and recent_activity take depth from 1 to 5.
    • /memory/recent caps page_size and max_related at 100.
  • Skills page: added memory-okf. memory-reflect and memory-defrag now work on project notes and are installed on their own. memory-agents is deliberately left off the page because Cloud agents are still internal.
  • Small behavior notes:
    • .bmignore escaping, and Emacs autosave files are never indexed.
    • Notes keep their created time through edits, moves, and reindexes.
    • move_note can rename .markdown to .md.
    • An empty CJK search returns a query_hint.
    • HTTP 429 responses are retried.
  • scripts/check-docs.mjs skips fenced code blocks when checking links. The footnote example on the Documents and PDFs page was failing the check as a missing asset.
  • Merged main into the branch, which includes the switch to the Node 24 LTS Docker image (Build and run the docs site on Node 24 LTS instead of Node 25 #51).

Notes

Verification

  • npm run check:docs passes (warnings only).
  • npm run build passes.
  • Every internal link and anchor resolves (checked by a script).
  • The new pages, redirects, and sidebar order were checked in the local dev server.

🤖 Generated with Claude Code

phernandez and others added 3 commits October 11, 2026 14:11
- What's New in v0.24 and Upgrade to v0.24 pages; renumber What's New
- Changelog v0.24 section plus missing v0.23.1/v0.23.2 patch notes
- Welcome callout points at v0.24
- MCP tools reference: POSIX read tools, revision guards, refusals as
  tool errors, compact/line reads, cross-project and valid-time search,
  metadata operators, MCP resources and the manual
- CLI and configuration reference: bm cat/grep/ls/find/tail/tree, man,
  wiki, okf, prune, install, import document, project index/remove,
  status --wait, HTTP transport loopback bind, retired settings
- Concepts: Markdown links as relations, locked notes, authorship,
  valid-time qualifiers, new Documents and PDFs page
- Cloud: deprecate sync/bisync in favor of push/pull, cloud project
  removal always deletes cloud files, read-only API keys
- Integrations: bm install, new Tau and Pi pages, Hermes/OpenClaw/Codex
  updates; pgvector 0.8 requirement for Postgres

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Remove the v0.23, v0.23 upgrade, Hermes plugin, Cloud app updates, agent
skills, OpenClaw plugin, and AI-friendly docs pages. Old URLs redirect to
the changelog or the current integration/reference page, and inbound
links point at those pages or the v0.23.0 GitHub release.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 11, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-23T12:50:34.810738Z 385c46e New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7497519faa

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread content/07.concepts/9.documents-and-pdfs.md
Resolve conflicts with the v0.23 patch, video, skills, and API key
changes on main:
- keep the v0.24 welcome callout and changelog patch notes
- keep main's API key wording (project-scoped keys are unreleased) and
  drop the "limit to specific projects" option; keep read-only keys
- take main's Team/Invite-only access rewrite, with a v0.24 note that
  --visibility now works and private is refused (#1343)
- drop the stale Hermes "managed install blocked" warning; the plugin
  has declared manifest_version 1 since Aug 28
- combine v0.23.2 folder-casing and Cloud review_mode notes with the
  v0.24 tool reference changes
- remove the What's New pages main had edited, as on this branch

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3fb2a9f3b1

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread content/10.reference/5.troubleshooting.md Outdated
Comment thread content/06.local/6.postgres-and-milvus.md
Comment thread content/10.reference/2.mcp-tools-reference.md Outdated
phernandez and others added 3 commits October 23, 2026 07:23
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J4ReQoGEkPz1CskmjPijvP
- Skills: add memory-okf; update memory-reflect and memory-defrag, which
  now work on project notes and are installed on their own
- Note .bmignore escaping, Emacs autosave exclusion, created-time
  preservation, .markdown to .md moves, CJK query_hint, and 429 retries
- check-docs: skip fenced code blocks when checking links, so example
  footnotes are not reported as missing assets

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J4ReQoGEkPz1CskmjPijvP
@phernandez phernandez changed the title docs: v0.24.0 release documentation docs: v0.24.0 and v0.24.1 release documentation Oct 23, 2026

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7a2cdd97af

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread scripts/check-docs.mjs Outdated
Comment thread content/07.concepts/7.semantic-search.md
Comment thread content/02.whats-new/06.changelog.md Outdated
Commands checked against the v0.24.1 CLI help:
- bm cloud upload: --no-sync does not exist; the flag is --no-index
- bm hook takes --harness on its subcommands, not on bm hook itself

Review findings:
- Troubleshooting: bm cloud prune deletes cloud files, not just index
  entries; say so and show --dry-run
- Postgres page: close the first ::note before opening the second
- edit_note table: merge the duplicate expected_checksum rows
- Configuration: reranker_max_document_chars defaults to 2000, not 0
- Changelog: don't promise page-cited provenance before enrichment ships
- check-docs: skip indented and tilde code fences too

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J4ReQoGEkPz1CskmjPijvP

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 63a1507eef

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread CLAUDE.md Outdated
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J4ReQoGEkPz1CskmjPijvP
@phernandez
phernandez merged commit 11bd5d5 into main Oct 23, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant