From 2f963b6b7248f0b23e29a997944467dfecd75f41 Mon Sep 17 00:00:00 2001 From: Rohit Ghumare Date: Thu, 28 May 2026 13:46:12 +0100 Subject: [PATCH] feat(connect): print `npx skills add` hint after successful wire MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit PR #677 shipped 5 MCP-only adapters (Warp, Cline, Continue, Zed, Droid) but didn't ship native skill installs, which left ~600 LOC of per-agent file-tree manipulation on the table. Turns out the vercel-labs/skills CLI already covers 4 of the 5 (warp, cline, continue, droid) plus 45+ other agents, reading SKILL.md files from any git repo and installing to the calling agent's native directory. This wires that path into the agentmemory UX without taking a new runtime dep: - `summarize()` in `src/cli/connect/index.ts` prints a one-line next-step pointing users at `npx skills add rohitg00/agentmemory -y` after any successful or already-wired adapter run. No subprocess spawn — keeps `connect` deterministic + offline-capable; the install is opt-in. - README "Other agents" section gets a "Native skills via `npx skills add`" subsection explaining the two-step pattern (`connect` for MCP, `skills add` for skill autoload) and listing the 50+ supported agents. - README install snippet bumps from one-line `connect` to the two-line flow so first-run users see both paths immediately. Tracked via #708. Closes the audit angle for #703 / #704 / #705 / #707 — see those issues' closing comments. #706 (Zed) remains open since the skills CLI keyword list doesn't include Zed yet. --- README.md | 22 +++++++++++++++++++++- src/cli/connect/index.ts | 10 ++++++++++ 2 files changed, 31 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index ac09238121..862e540fe2 100644 --- a/README.md +++ b/README.md @@ -93,7 +93,8 @@ npm install -g @agentmemory/agentmemory # once — bare `agentmemory` o # sudo npm install -g @agentmemory/agentmemory agentmemory # start the memory server on :3111 agentmemory demo # seed sample sessions + prove recall -agentmemory connect claude-code # wire your agent (also: copilot-cli, codex, cursor, gemini-cli, ...) +agentmemory connect claude-code # wire MCP into your agent (also: copilot-cli, codex, cursor, gemini-cli, ...) +npx skills add rohitg00/agentmemory -y # install 8 native skills so your agent knows when to use the tools ``` Or via `npx` (no install): @@ -550,6 +551,25 @@ Full guide: [`integrations/hermes/`](integrations/hermes/) Start the memory server: `npx @agentmemory/agentmemory` +#### Native skills via `npx skills add` (50+ agents) + +agentmemory ships 8 skills (`remember`, `recall`, `recap`, `handoff`, `forget`, `commit-context`, `commit-history`, `session-history`) in the Claude-Code-style `/SKILL.md` format. The [`skills`](https://npmjs.com/package/skills) CLI by vercel-labs auto-installs them into the calling agent's native skill directory across 50+ agents (Claude Code, Cursor, Cline, Continue, Droid, Warp, Codex, Antigravity, Kiro, OpenCode, Goose, Roo, Trae, Windsurf, and more): + +```bash +npx skills add rohitg00/agentmemory -y # auto-detects the calling agent +npx skills add rohitg00/agentmemory -y -a warp # explicit agent +npx skills add rohitg00/agentmemory -y -a '*' # install to every installed agent +``` + +This is **complementary** to `agentmemory connect `: + +- `agentmemory connect ` writes the MCP server config so the tools are available. +- `npx skills add rohitg00/agentmemory` installs the skills so the agent knows when to call them. + +For the few agents the skills CLI doesn't cover yet (Zed v1.3.x and below), drop the 8 SKILL.md files under the agent's native skill directory yourself — same format works everywhere. + +#### Standard MCP block + The agentmemory entry is the **same MCP server block** across every host that uses the `mcpServers` shape (Cursor, Claude Desktop, Cline, Roo Code, Windsurf, Gemini CLI, OpenClaw): ```json diff --git a/src/cli/connect/index.ts b/src/cli/connect/index.ts index 9af6b7d15d..c32adb07ae 100644 --- a/src/cli/connect/index.ts +++ b/src/cli/connect/index.ts @@ -192,5 +192,15 @@ function summarize( `${stubs.length} agent(s) require manual install — see docs links above.`, ); } + + const wiredAny = results.some( + (r) => r.result.kind === "installed" || r.result.kind === "already-wired", + ); + if (wiredAny) { + p.log.info( + "Next: install agentmemory's 8 skills into the same agent(s) so they know when to call the tools:\n npx skills add rohitg00/agentmemory -y", + ); + } + p.outro("Restart any wired agent (or open a new session) to pick up agentmemory."); }