Skip to content

docs: fix drift in Platform Installers - #311

Draft
jack-arturo wants to merge 1 commit into
mainfrom
docs/audit-cli-platform-installers-20260818
Draft

docs: fix drift in Platform Installers#311
jack-arturo wants to merge 1 commit into
mainfrom
docs/audit-cli-platform-installers-20260818

Conversation

@jack-arturo

Copy link
Copy Markdown
Member

Routine docs-accuracy audit. First review of this page — no prior review state existed for cli/platform-installers.

Claim Current state Fix Evidence
Installer overview table lists only cursor, claude-code, codex, openclaw, hermes copilot is a first-class platform installer command (routed in src/index.ts, advertised in --help), writing hooks/scripts/rules under ~/.copilot/ Added a copilot row with its generated files and MCP config location mcp-automem@92c2e33:src/index.ts#L380, #L208, src/cli/copilot.ts#L421-L422, #L572-L573
Claude Desktop snippet uses server key automem and args: ["@verygoodplugins/mcp-automem"], under a tip saying setup "will print the exact JSON snippet" buildClaudeDesktopSnippet() — the function setup prints — emits key memory and args: ["-y", "@verygoodplugins/mcp-automem"] Snippet updated to match the generated one mcp-automem@92c2e33:src/cli/templates.ts#L5-L18, printed at src/cli/setup.ts#L199
Cursor MCP snippet has no env block and no -y, immediately above a note stating "the generated examples and deeplink flow assume the env block is present" The cursor installer prints key memory, args: ["-y", "@verygoodplugins/mcp-automem"] and an env block with AUTOMEM_API_URL Snippet updated to match the printed one (self-contradiction removed) mcp-automem@92c2e33:src/cli/cursor.ts#L333-L344
Mermaid diagram: claude-code command~/.claude/hooks/ + ~/.claude/scripts/ installHookScripts() writes only into <targetDir>/hooks/. ~/.claude/scripts/ appears solely in RETIRED_FILES, i.e. files the installer deletes from older installs Diagram node reduced to ~/.claude/hooks/ mcp-automem@92c2e33:src/cli/claude-code.ts#L526-L546, #L31-L40
templates/CLAUDE_DESKTOP_INSTRUCTIONS.md link was branch-pinned (/blob/main/) File exists at HEAD; link was not a permalink Converted to a commit permalink mcp-automem@92c2e33:templates/CLAUDE_DESKTOP_INSTRUCTIONS.md

Verified against: verygoodplugins/mcp-automem@92c2e33

Checked and found accurate, left unchanged: the six mcp__memory__* permissions merged by claude-code; the Hermes three modes and the five-tool include list with delete_memory excluded; the OpenClaw plugin/mcp/skill mode outputs including plugins.entries.automem and <workspace>/config/mcporter.json; the Codex TOML snippet; the config command's Claude Desktop / Claude Code / Hermes output set.

Questions

  • The Claude Desktop and Cursor snippets were changed to server key memory for consistency with the generated output and with the page's own "If your MCP server key is not memory…" note. Cursor's detector accepts both memory and automem (src/cli/cursor.ts#L206, #L220), so automem was not wrong — flagging in case the automem spelling was a deliberate house style for these examples.
  • The page describes the OpenClaw --mode flag without saying which mode is the default. parseArgs defaults to plugin (src/cli/openclaw.ts#L1175). Left alone as a possible intentional simplification, since the page already labels plugin "(recommended)".

Unverified

None — every code-anchored claim on this page resolved to current source.

Follow-ups

  • migrate, uninstall, and recall are CLI commands with no coverage on this page or (as far as this audit checked) elsewhere in cli/. Not platform installers, so out of scope for this page, but worth a docs decision.

Generated by Claude Code

- add the missing `copilot` installer row to the overview table
- correct the Claude Desktop snippet to the one `setup` prints (server key `memory`, `-y` arg)
- correct the Cursor MCP snippet to what the `cursor` installer prints (`-y` arg + env block)
- claude-code installer writes only ~/.claude/hooks/; ~/.claude/scripts/ is retired-file cleanup only
- pin the CLAUDE_DESKTOP_INSTRUCTIONS.md link to a commit permalink

Verified against verygoodplugins/mcp-automem@92c2e33

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Tnorev9PMn8gL7uTyZzege
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying automem-website with  Cloudflare Pages  Cloudflare Pages

Latest commit: 948d250
Status: ✅  Deploy successful!
Preview URL: https://ac4ce64c.automem-website.pages.dev
Branch Preview URL: https://docs-audit-cli-platform-inst-alwj.automem-website.pages.dev

View logs

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.

2 participants