docs: add Supermemory CLI docs and embed SMFS into main nav#1121
docs: add Supermemory CLI docs and embed SMFS into main nav#1121Dhravya wants to merge 4 commits into
Conversation
Document the Supermemory CLI (npx supermemory) — previously undocumented. Adds a "Command Line (CLI)" group under the Developer Platform tab: - cli/overview: install, auth, config scopes, the cloud-CLI vs local-server split - cli/commands: full command/flag reference (add, search, tags, keys, etc.) - cli/local: npx supermemory local, cross-linked to self-hosting docs Also moves SMFS from a standalone top-level anchor into a group inside the main Developer Platform anchor so it's embedded rather than feeling detached. Page URLs are unchanged, so no redirects are needed. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
Claude finished @Dhravya's task in 56s —— View job Reviewing PR #1121
SummaryReviewed this documentation PR. No issues found — it's a clean addition of CLI docs and a nav restructure. What was reviewed:
Result: ✅ Approved with score 10/10. Ready to ship. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Deploying with
|
| Status | Name | Latest Commit | Updated (UTC) |
|---|---|---|---|
| ✅ Deployment successful! View logs |
supermemory-mcp | 5437f97 | Jun 16 2026, 02:52 AM |
There was a problem hiding this comment.
Overview: Adds comprehensive CLI documentation (overview, command reference, local server) and moves SMFS into the main Developer Platform nav.
Issues found: None — this looks good to ship.
This is a clean documentation PR. The docs.json is valid JSON with correct structure, all referenced pages exist, and the SMFS restructure maintains existing URLs (no redirects needed). The CLI docs comprehensively cover cloud commands and the local server with clear examples.
Score: 10/10
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
supermemory-app | 5437f97 | Commit Preview URL Branch Preview URL |
Jun 16 2026, 02:53 AM |
Reorder the Developer Platform sidebar so readers see what Supermemory DOES before how they access it (Diátaxis / progressive-disclosure): - Promote core features (add/search/profiles/manage) to right after Getting Started, renamed "Core Features" - Demote Self-Hosting, Command Line (CLI), and SMFS to the bottom as discoverable sections rather than top-of-sidebar groups Rework the Overview page to actually sell and to be the discovery point for secondary surfaces: a capabilities card grid up top, a "Start building" row, and a "Ways to use Supermemory" row (SDKs, CLI, filesystem, self-host) so they're a delightful find, not prime real estate. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Demoting the delivery surfaces hid "you can run it yourself" until you scroll. Make the hosted-vs-self-hosted choice obvious without restoring tooling-first sidebar ordering: - Add a Self-host link to the top navbar (visible on every page) - Add a hosted-or-self-hosted callout directly under the Overview hero Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The Overview didn't carry the positioning the product earns. Lead with proof and the technical edge instead of generic capability cards: - Open with the category + the #1-on-every-benchmark claim and the "reasons over a directed knowledge graph" thesis - Add a benchmarks table (LongMemEval 81.6%, LoCoMo, ConvoMem — all #1) - Replace the generic "what you can build" grid with "What makes Supermemory different": reasons (not retrieves), directed graph, whole context stack in one system, multi-modal, built to build on, run anywhere - Keep deployment callout, how-it-works, the three context approaches, and the start-building / ways-to-use cards Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
What
New CLI docs. The Supermemory CLI (
npx supermemory) had no documentation. Adds a Command Line (CLI) group under the Developer Platform tab:cli/overview— what the CLI is, install (npx supermemoryor global), auth, config scopes, env vars, global flags, and the two-things framing (manage cloud memory vs. run a local server).cli/commands— complete command/flag reference:add,search,remember,forget,update,profile,docs,tags,keys,connectors,plugins,team,status,logs,billing, utility commands, scoped-keys mode, and scripting/CI patterns.cli/local— documentsnpx supermemory local(the self-hosted server) with a cloud-CLI-vs-local-server comparison table, cross-linked into the existing Self-Hosting docs rather than duplicating them.SMFS embedded into main nav. SMFS was a separate top-level anchor (its own dropdown), which made it feel detached. Moved it to a group inside the main Developer Platform anchor ("SMFS (Memory Filesystem)", after Connectors) and removed the standalone anchor.
Why
Surfaces the CLI (cloud commands +
npx supermemory local) which was undocumented, and brings SMFS into the main docs flow so it's discoverable instead of sitting off on its own.Notes for reviewers
apps/cli/src/commands/*,apps/cli/src/index.tsin the mono repo) and the existing self-hosting docs.smfs/*) are unchanged — nav placement only, so no redirects needed.npx supermemoryper how the product is presented. If the published npm package name is@supermemory/clirather than baresupermemory, the install /npxlines incli/overviewandcli/localshould be adjusted.docs.jsonvalidated as JSON; all referenced pages exist.🤖 Generated with Claude Code