Docs overhaul: v0.22 accuracy pass, teams/partners sections, full-site review#32
Open
phernandez wants to merge 87 commits into
Open
Docs overhaul: v0.22 accuracy pass, teams/partners sections, full-site review#32phernandez wants to merge 87 commits into
phernandez wants to merge 87 commits into
Conversation
- Add Suspended member status (post-grace-period seat overage) - Document project-archive downloads for User Admin and above (#1403) - Invite dialog assigns any role at or below the inviter's, not just Editor/Viewer; member management is User Admin+, owner-only actions split out - Fix project visibility table: add missing Private row, correct the Standard visibility value to `workspace`, share access is view/edit - What's New Teams page: roles are five levels, not three - Fix dangling sentence and typo Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Add the categories parameter to the search_notes reference (exact observation-category matching, singular category alias, comma-split strings, and the implicit entity_types default to observations), and a note on the metadata-search page distinguishing observation categories from frontmatter metadata_filters. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Cherry-picked from docs-overhaul-2026-06: - scripts/check-docs.mjs + CI workflow: broken internal links and missing assets fail the build; version literals and unreferenced screenshots warn (downgraded from error to keep the homepage version badge and release cards) - docs/screenshots.json manifest, filtered to screenshots that exist on main; docs/docs-audit.md page-by-page verification register - New pages: integrations index (/integrations), Cloud CLI guide (/cloud/cloud-cli), Contact Support (/reference/contact-support) - Cloud CLI team-workspace section updated for v0.22 team-safe push/pull (sync/bisync are blocked on team workspaces) - Fix broken /whats-new/v0.19.0 link in the migration guide; member management references point at Settings -> Members per current UI Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Merge the docs-overhaul branch's verified reference pass, re-checked against current basic-memory source: - Common params: add project_id (external UUID, disambiguates same-named projects across workspaces); workspace is not universal — it appears on write_note, edit_note, create_memory_project, and delete_project only - write_note/edit_note: document workspace param (v0.22.1 parity) and directory aliases (folder, dir, path) - search_notes: note_types is case-insensitive with aliases, full query/pagination alias list, metadata_filters accepts JSON strings - view_note: remove page/page_size (not in the tool signature) - list_memory_projects: returns external project IDs; workspace param replaced by output_format - New UI tools section: search_notes_ui, read_note_ui - Schema tools: output_format on validate/infer/diff Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
New public-facing page for the managed-service-provider program: partner portal tour, claim-and-activate onboarding, staff roles, customer lifecycle (provision, seat caps, suspend/archive), WorkOS SSO with JIT provisioning caveats, and the seat-day billing model with committed minimums and CSV statements. Linked from the Teams guide. Operator internals (bmc/bmp CLI, Polar wiring, webhooks) are intentionally left out. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Drop the hero/card-grid landing page (computer graphic, spotlight cards) in favor of a lean Welcome page that keeps the hero messaging: tagline, What's New callout, pick-your-path cards into start-here, and links to integrations, teams, GitHub, and llms.txt. Version-bump checklist updated to point at the Welcome page's What's New callout instead of the old version badge. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Docus renders content/index.md through a bare landing template with no sidebar or page header, so the Welcome page moves into the docs collection as content/0.welcome.md (top of the left nav) and / issues a 301 to /welcome. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The "How it works" flow no longer mentions SQLite or running a server — notes are Markdown files with a search index, and the assistant connects through MCP. Fix typos (WikiLink, expire, Related, automatically) and describe the Getting Started card as the workflow guide rather than an installation guide. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Mermaid component now passes beautiful-mermaid an enriched theme matching the site palette (orange accent for arrows, stone surfaces and borders, distinct node fill/stroke) in both color modes, instead of bare two-color mono derivation. what-is-basic-memory diagrams reworked: knowledge graph is a compact LR fan-out instead of two stacked subgraphs, build_context is a linear pipeline without the confusing back-edge, the refinement chain runs horizontal, and the redundant "Knowledge growth over time" loop (a near-duplicate of the feedback loop that rendered as a tall column of boxes) is removed. All new diagram sources verified against the beautiful-mermaid renderer. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The page is local setup — default ~/basic-memory project, choosing where notes are saved, managing projects — so it now lives at /local/getting-started, second in the Local nav after installation. Old URL 301-redirects, all nine inbound links updated, and the Welcome/what-is cards describe the page accurately. Local section renumbered (cli-basics, mcp-tools, user-guide shift down one); why-basic-memory fills the start-here numbering gap. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Its case for the product is already made by what-is-basic-memory (Why Basic Memory, Seeing into the black box) and the vs-built-in-memory concept page. Old URL 301-redirects to what-is-basic-memory; the one inbound link is removed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The What's New changelog page (previously titled "Basic Memory") is now "Changelog" and sits right after Teams in the nav. It carries written sections for v0.22 through v0.19 — sourced from the v0.22.0 release page and the basic-memory CHANGELOG — with GitHub release-tag links, and keeps the auto-fetched release feed at the bottom. The dedicated v0.22.0 page is removed; /whats-new/v0.22.0 and a new /changelog alias both 301 to /whats-new/changelog. Inbound cards and the Welcome callout point at the changelog, and the version-bump checklist drops the rename-the-version-page step. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
v0.19 shipped four months ago; upgrade details live in the GitHub release notes, which the changelog's v0.19 section now links. Old URL 301s to the changelog, and check-docs drops its stale exemption. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
bisync is no longer supported — its three-way mirror breaks on team workspaces — and push/pull fully replaces it. Cloud Sync is rewritten around pull → edit → push as the standard workflow for personal and team workspaces alike, with one-way sync and check remaining as personal-only tools. All bisync recipes in the cloud guide, cloud CLI, user guide, VS Code, Obsidian, CLI reference, troubleshooting, configuration, and copy-between-workspaces pages now use push/pull (including the caveat that additive push doesn't propagate deletions). The edit-locally-and-in-the-app page is removed; its URL 301s to /cloud/cloud-sync and inbound links are updated. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Source-verified corrections from the docs audit: - basic-memory sync does not exist — troubleshooting and the local user guide now point at automatic sync / bm reindex / bm reset - Snapshot restore syntax corrected to the real CLI form (bm cloud restore <path> --snapshot <id>; browse takes --prefix) - Metadata filter operators: remove nonexistent $contains, add the real $gt/$gte/$lt/$lte and $between; edit_note gains its two missing insert operations (AI assistant guide) - output_format values are text/json — drop ascii/ansi/default claims - Fix invalid `bm search_notes --cloud` example in routing - semantic_embedding_batch_size default is 2, not 64 (two pages) - configuration: local_sync_path (not the legacy cloud_sync_path), cloud_mode documented as env-derived rather than a settable field, Postgres URL uses postgresql+asyncpg:// - Project ZIP download requires User Admin+ (copy-between-workspaces) - Local projects take a positional path, not --local-path (VS Code) - Python floor is 3.12; drop hard-coded 0.19.x version output from the local quickstart; fix two broken anchors Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Tool counts ("17 MCP tools"), skill counts, theme counts, and CLI
version floors go stale with every release — replace them with
count-free phrasing. The skills table gains the five missing skills
(capture, continue, curate, literary-analysis, ci-capture); the
OpenClaw page points at the skills collection instead of duplicating
a partial table; Hermes drops its dated upstream version pin.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The phrase described the removed bisync auto-mirror model. Push/pull moves changes both ways but additively and explicitly — cards, headings, and blurbs across ten pages now say what actually happens. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The previous Docker page lost the SQLite index and config on container recreate (it never mounted /home/appuser/.basic-memory) and gave the wrong SSE endpoint. The overhaul branch's rewrite matches the shipped Dockerfile and compose file: config volume, version-based healthcheck, explicit SSE transport flags, security caveats, no stale tags. MCP spec link now points at modelcontextprotocol.io. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Drop commitments to in-progress work: the "coming soon" agent-presence section on the Teams page now describes what's live (agent writes in the Activity feed); the Claude Research Mode page is removed (feature availability unverifiable) with its troubleshooting bullet inlined. The pre-v2 cloud user guide is removed — it contradicted the Web App reference; both URLs 301 to current pages. Surface shipped behavior: shared-note Readable/Full width toggle, workspace selection on the Snapshots page (three pages), the in-app Connect-your-agent flow on the integrations index, and clarified role-viewing (Settings → Teams) vs member management (Settings → Members). How-to pages drop "v0.19" launch framing and a stale project-add --cloud example. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Quickstart: new accounts land in a seeded Getting Started tutorial project with a floating onboarding guide (replayable from Settings -> General), the expected project list reflects that default, and the first-note example no longer collides with the seeded project's name. Pre-overhaul screenshots (signup, project list, first note) removed pending recapture. Web app: Settings table now matches the current nav (adds Members, Notifications, Audit Logs, Version; notes team download role-gating and onboarding replay), and new Activity and Explore sections document the live activity feed with agent writes and the 3D graph view. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- semantic-search carried its platform-compatibility table and Intel Mac workaround twice; the nested copy is now a pointer to the canonical section - knowledge-format and observations-and-relations agree on terminology: inline wikilinks index as generic links_to relations (verified against the parser), and each format section cross-links the deep-dive - ai-assistant-guide's end-of-page tool tables (already missing newer tools) replaced with a pointer to the MCP Tools Reference - technical-information's worked example JSON now corresponds to the markdown input above it (requires/affects relations, single heading, markdown code fence) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Collects the July 2026 audit leftovers that need a human or a browser: screenshots to capture (onboarding, Activity, Explore) or re-verify (Claude UI sets, pre-v2 snapshots/themes, teams labels), production checks for the onboarding-overhaul docs, external-product verifications (ChatGPT/Claude/Codex/Hermes), and open structural decisions. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The AI assistant guide was ~900 lines of tool documentation that drifted from the MCP reference. It's now a focused setup page: install Agent Skills (recommended), or add standing instructions via Claude project settings / CLAUDE.md / AGENTS.md with a ready-to-paste block, or direct the assistant conversationally — plus what good usage looks like. The extended guide on GitHub is linked for people who want the long form. Contact Support leaves the left reference nav (navigation: false) and surfaces site-wide in the right-hand TOC under a "Contact Us" section, ahead of the community channels. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Skills development moved into the monorepo (basic-memory/skills); the old basic-memory-skills repo is now just a distribution target. All install commands become `npx skills add basicmachines-co/basic-memory/skills` (with --skill/--agent/--list variants and a CLI-version fallback note per the skills README), the manual install clones the monorepo, and GitHub links point at the skills/ tree. The skills table matches the README's public list (memory-ci-capture is CI-internal and unlisted). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
New "Using skills" section: skills activate automatically when a request matches, with plain-language example prompts for invoking a specific skill by name, and the Claude Code slash-command shortcut. Short version on the What's New announcement. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
287 page findings (158 incorrect, 95 confusing, 34 redundant) plus 32 cross-cutting findings from a 70-agent per-page review, ordered by nav with evidence and suggested fixes. Checkbox per finding. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Shared Notes now open by distinguishing public links from team sharing: teammates get notes automatically through team projects, so share links are for readers outside the workspace. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
If no snapshot or backstop covers the loss, nightly backups exist independently of user snapshots and support may be able to recover the data — with what to include in the email. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…utton Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The Contact Support page now leads with support@ (flagged/monitored for user support) plus the in-app feedback button; hello@ stays for sales and partner inquiries, which the Partners page already uses. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Partners moves out of Teams into a top-level section (nav position 5, later sections renumbered; URLs unchanged, /teams/partners 301s). The single page becomes five, technical and feature-forward: - Partner Program: value framing around the four pillars (provision customers, SSO, consolidated invoicing, full audit log), portal tour, claim-and-activate setup, link to basicmemory.com/partners - Customer Provisioning: isolated workspaces, list columns as shipped, seat caps, lifecycle, and correctly-scoped customer-visible audit - Customer SSO: verify domain first, setup portal opens directly in a new tab (nothing to copy/email), JIT is ON by default with the seat-consumption warning inverted to match - Billing: seat-day metering, committed minimums, statements/CSV as rebilling data, Add seats restricted to Owner/Billing roles - Team and Audit: scoped staff roles (Admin billing qualified), audit trail with the customer-visible action subset All six review findings for the old page are folded in. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
local-install becomes the canonical install-and-connect page: the MCP section is retitled Connect your MCP client with the Homebrew config variant and links for other clients; choose-where-notes-live defers to getting-started (which now owns multi-project setup). getting-started fences AI prompts as text instead of bash and uses the CLI for the default project instead of a JSON hand-edit. cli-basics notes hybrid is the default search mode and uses a permalink-style read-note identifier. mcp-tools-local fixes the output_format default claim (build_context defaults to json), links memory:// URLs, and points at server setup. The user guide gets the real reset semantics (plain reset only deletes the index; --reindex rebuilds), the two missing edit_note insert operations, a named update_permalinks_on_move setting, and trims its duplicated memory-URL formats, multi-project, and troubleshooting sections to summaries plus links. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Highlights, all source-verified: - projects-and-folders: removed the fictional session switching model (no switch_project tool, no bm project switch command) — tools take a project parameter per call; permalink prefixing described as the generation-time default it is - knowledge-format: permalinks derive from file paths (not titles) in both places; dead Web Editor anchor fixed; folder-organization and quoting-rule duplications deferred to their canonical pages - memory-urls: constrained servers error on foreign project prefixes rather than ignoring them; prefix detection always runs (permalinks_include_project only affects generation); phantom fourth resolution step merged into step 2; cross-project syntax shown in a real relation; title-form example added - schema-system: unimplemented --save example removed; nonexistent Off validation mode dropped; fabricated CLI transcripts replaced with real output descriptions and actual validator messages; enum example made self-consistent; automatic-schema-reading claims softened to skill/instruction-based reality - semantic-search: ONNX pin commands that work per install method; ranking sentence reconciled with chunking; bm reindex documented as incremental with --full added; config table trimmed to tunables - metadata-search: space-separated tag shorthand corrected to repeated tokens; comparison operators accept strings; date-range example added - observations-and-relations: validation is on-demand, not at write time; canvas formatting repaired; vs-built-in card points at the integrations index Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The resolution controls (BASIC_MEMORY_MCP_PROJECT constraints, prefix extraction, default fallback) are local-server behavior not exposed in cloud. The concepts page keeps a one-paragraph summary with a link. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Canvas writes Obsidian .canvas files, so it lives under Local now with a scoping note (cloud users get the Explore graph view); the MCP reference marks the tool local-only, and the old concepts URL 301s. Also drops the page's duplicate H1. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
A paste-once instruction that trains the agent's built-in memory to route long-term knowledge to Basic Memory and reference it from native memories — short-term cache, long-term store. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
A user asked how — the answer was buried in the MCP reference table. metadata-search gains a Searching observations by category section (MCP + CLI examples, exact matching, the entity_types default), the CLI reference documents the --category flag with an example, and cli-basics shows the one-liner. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Numeric prefixes sort lexically, so 10.reference landed between 1.start-here and 2.whats-new after the renumber. All top-level sections and integration pages are now two-digit padded (URLs unchanged); integrations reordered per nav decision (Codex before ChatGPT; OpenClaw and Hermes after Gemini) and round-one integration fixes included (index card claims, claude-desktop watcher command and cloud/local troubleshooting split, claude-code /mcp auth flow and log path, ChatGPT's real connector path and paid-plan wording, gemini auth trigger and uvx version check). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Codex: uvx no-install variant and a troubleshooting check that works for the setup the page teaches; api-keys defers the full Codex walkthrough here. Cursor: real config mechanism (~/.cursor/mcp.json or .cursor/mcp.json, Settings -> MCP) replacing the grafted Claude menu path; fixed stale docs link; uvx-aware troubleshooting. VS Code: CLI prerequisite moved before first bm command, --cloud on project add, stdin form for write-note, concrete Copilot MCP config, sync workflow defers to the Cloud Sync Guide. Obsidian: --cloud flags, honest login step, and a first-sync split (existing vault pushes to seed the empty cloud project; cloud-first pulls). Skills: detail paragraphs for the four previously undocumented skills. OpenClaw: uv prerequisite (auto-install contradiction resolved), enable --slot memory step, real config defaults, corrected /bm-setup description, complete slash-command story, subset-not-identical bundled-skills claim, replace_section on edit_note, no project-switching implication. Hermes: canonical monorepo install command (--path integrations/hermes) on both pages, a how-to-tell-if-affected patch warning, tool-count literals dropped, bundled-skill antecedent explained. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…sty fixes The how-to pages taught schemas as enforcing markdown sections; they validate observation categories, relations, and frontmatter. ADR and research examples now speak that language (and the ADR schema matches its own prompt); the accepted-ADRs example explains the category-vs-frontmatter split. note-taking drops the invented per-update authorship claim (cloud File History carries versioning), validation is on-demand rather than at creation, and the semantic/metadata search examples now actually demonstrate what they claim. personal-knowledge stops implying set-cloud syncs notes, uses one CLI alias, and creates the project it routes. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Lead with the create_memory_project path (an AI prompt) instead of mkdir + local CLI; the repo-folder variant stays as the local option. How-to examples should be cloud-and-local unless the topic is the local/cloud split itself. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Docs are the most shared content type — web app viewing, team access, and share links make the case; the repo docs/ folder stays as the local alternative. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…note Project setup leads with the AI prompt (cloud or local, with the folder variant for local installs), and a note up front sets the stance: the agent organizes and clarifies your thinking — it doesn't generate text you never read. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
CLI reference (all source-verified): --name on cloud sync/check,
read-note pagination flags removed (they don't exist), recent-activity
default corrected to 10, the fictional --workspace bullet replaced
with --project-id, unimplemented schema infer --save dropped, --strict
semantics corrected (errors only), schema-validate positional target,
bm update skips uvx, project move updates config only, --overwrite and
--full and all six edit operations documented, import claude projects
added.
MCP reference: UI tools section removed (registrations disabled in the
current release), cloud_info/release_notes described as the static
resources they are, recent_activity discovery mode scoped correctly,
read_content behavior per file type, Discovery grouping de-clouded.
Troubleshooting: reset --reindex everywhere the rebuild is promised,
project info gets its required argument, the real log file path (the
old command matched nothing and the "cloud log" was the OAuth token
cache), stale sync-in-progress section removed, cloud-sync fixes owned
by the Cloud Sync guide, AI prompts labeled as prompts, WAL files
handled via reset instead of manual rm.
Configuration: local_sync_path, skip_initialization_sync described as
the cloud/stateless flag it is, {file} placeholder and built-in
mdformat behavior documented, default_project's real default, version
floor dropped. Technical info: entity model defined once, example
JSON self-consistent. Docker env table sourced correctly; llms-txt
prompt fenced as text. ai-assistant-guide install command matches its
prose.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The vs-built-in-memory tip (cache/store routing saved into native memory) and the assistant guide's standing instructions are complementary — now each points at the other. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Postgres with pgvector is the configuration Basic Memory Cloud runs on; the page now shows the two env vars to use it and links the pool tuning settings, instead of framing it as development-only via a compose file. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Most were already resolved by the per-page passes; this closes the verified leftovers: - Snapshots are workspace-wide, said consistently (restore guide, file history, What's New) - The workspace selector is named in the web app layout and used in join-a-team's step 2 - What's New announcements retitled (Introducing Teams, Cloud App Updates) so nav labels no longer collide with the canonical section pages - Journey fixes: getting-started no longer bounces readers back to the quickstarts, cloud-guide's install link points at the install page, local-install greets quickstart graduates, and the four dead-end pages (canvas, llms-txt, technical information, routing) get Next Steps cards - Last duplication trimmed: the local user guide's relation/observation syntax section defers to the canonical concepts page; project info example gets its required argument Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
All content-referenced images exist; the May-June v2 set is current. Removes the pre-v2 spares the todo flagged (old Claude walkthrough shots, signup/first-note, themes.gif, superseded accept-invite pair) and collapses the todo's screenshot section to the verified state. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Verified against app.basicmemory.com: the seeded Getting Started project, /notes route, Settings tabs, Activity feed, Explore graph, feedback button, and support email all match the docs. Three things didn't and are fixed: - "Settings -> General -> Show onboarding" doesn't exist; the replay surface is the Help Center (account menu -> Help) with the Connect Your AI Tool walkthrough, endpoint copy button, and test prompt - There is no workspace selector dropdown — each workspace (personal and teams) is its own sidebar section; teams pages and the web app layout table now say so - The graph entry point is Graph in the sidebar with Project / Structured / Explore tabs (Explore is 2D/3D); themes are saved per-browser, which the themes page now notes Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 2b33a87f75
ℹ️ 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 on lines
8
to
10
| --- | ||
| title: "Quickstart: Cloud" | ||
| icon: i-lucide-cloud |
There was a problem hiding this comment.
When rendering /local/getting-started, this frontmatter starts a quickstart card without the required opening ::card (and surrounding :::card-group), so the later ::/::: closers are unmatched and the page shows/breaks this block instead of rendering the cards. Add the missing card-group/card openers or remove the stray card metadata.
Useful? React with 👍 / 👎.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Full documentation overhaul for the current product state (basic-memory v0.22.x + cloud July releases), in ~87 commits:
Structure
/→/welcome); Changelog consolidated as the single history pagenuxt.config.tsAccuracy (source-verified against basic-memory and basic-memory-cloud)
docs/review-findings.md)switch_project,bm project switch,basic-memory watch,basic-memory sync, read-note pagination,--workspaceon tools, schema--save,validation: off), corrected permalink derivation (file path, not title), sync semantics (push/pull, no bisync,--cloudon cloud project creation),reset --reindex, log paths, third-party UI paths (ChatGPT, Cursor)Voice/positioning
Tooling
scripts/check-docs.mjs(broken links/assets fail CI; version literals and orphaned screenshots warn) + GitHub Actions workflowRemaining known work is tracked in
docs/todo.md(external-product UI verifications, a few open decisions).🤖 Generated with Claude Code