#1 Persistent memory for AI coding agents based on real-world benchmarks
TypeScript agentmemoryagentsaiclaudeclaudecodecodexcopilotcursorgenaiharnesshermesmemoryompopenclawopencodepi
fix(cli): rerender splash banner + README npx caveat (#411)
Rohit Ghumare9344cfd502c1
diff --git a/README.md b/README.mdindex 245dad27..4fbbea9b 100644--- a/README.md+++ b/README.md@@ -53,6 +53,7 @@</p><p align="center">+ <a href="#install">Install</a> •<a href="#quick-start">Quick Start</a> •<a href="#benchmarks">Benchmarks</a> •<a href="#vs-competitors">vs Competitors</a> •@@ -68,6 +69,27 @@---+## Install++```bash+npm install -g @agentmemory/agentmemory # once — bare `agentmemory` on PATH+agentmemory # start the memory server on :3111+agentmemory demo # seed sample sessions + prove recall+agentmemory connect claude-code # wire your agent (also: codex, cursor, gemini-cli, ...)+```++Or via `npx` (no install):++```bash+npx @agentmemory/agentmemory+```++Heads-up — npx caches per version. If a bare `npx @agentmemory/agentmemory` serves an older release, force the latest with `npx -y @agentmemory/agentmemory@latest`, or clear the cache once with `rm -rf ~/.npm/_npx` (macOS/Linux; on Windows delete `%LOCALAPPDATA%\npm-cache\_npx`). The first npx run from v0.9.16+ prompts to install globally inline so the bare `agentmemory` command works everywhere afterwards.++Full options at [Quick Start](#quick-start) below. Agent-specific wiring at [Works with every agent](#works-with-every-agent).++---+<h2 id="works-with-every-agent"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-agents.svg"><img src="assets/tags/section-agents.svg" alt="Works with every agent" height="32" /></picture></h2>agentmemory works with any agent that supports hooks, MCP, or REST API. All agents share the same memory server.@@ -321,6 +343,28 @@ npx @agentmemory/agentmemory demoOpen `http://localhost:3113` to watch the memory build live.+### Recommended: install globally++`npx` caches per-version. If you ran `npx @agentmemory/[email protected]` last week, a bare `npx @agentmemory/agentmemory` may serve the stale 0.9.14 from `~/.npm/_npx/`, not the latest release. Install once and the bare `agentmemory` command works everywhere:++```bash+npm install -g @agentmemory/agentmemory+agentmemory # start the server (same as the npx form)+agentmemory stop # tear it down+agentmemory remove # uninstall everything we created+agentmemory connect claude-code # wire one agent+agentmemory doctor # interactive diagnostics + fix prompts+```++From v0.9.16 onward, the first npx run prompts you to install globally inline — answer `Y` once and you're set. If you skip, fall back to either of these for a fresh fetch:++```bash+npx -y @agentmemory/agentmemory@latest # forces latest from npm (cross-platform)+rm -rf ~/.npm/_npx && npx @agentmemory/agentmemory # macOS/Linux only (POSIX shell)+```++On Windows / PowerShell, the equivalent cache clear is `Remove-Item -Recurse -Force "$env:LOCALAPPDATA\npm-cache\_npx"` — the `npx -y ...@latest` form above is the cross-platform option.+### Session ReplayEvery session agentmemory records is replayable. Open the viewer, pick the **Replay** tab, and scrub through the timeline: prompts, tool calls, tool results, and responses render as discrete events with play/pause, speed control (0.5×–4×), and keyboard shortcuts (space to toggle, arrows to step).diff --git a/src/cli/splash.ts b/src/cli/splash.tsindex bc7f7b46..ad18b2ae 100644--- a/src/cli/splash.ts+++ b/src/cli/splash.ts@@ -42,17 +42,18 @@ function getTerminalWidth(): number {const TAGLINE = "Persistent memory for AI coding agents";-// Block-art "agentmemory" lettering. Hand-drawn in box-drawing chars so-// we don't need a figlet dependency. Each row is 70 columns wide which-// gives ~25 cols of breathing room on the 120-col tier.+// "agentmemory" rendered in figlet's standard font (verified output —+// regenerate via `figlet agentmemory` if you change the wordmark). Each+// row is exactly 70 columns wide so the banner aligns cleanly inside+// the 2-col left margin we add below.function fullBanner(version: string): string {const logo = [- " _ ",- " __ _ __ _ ___ _ _ | |_ _ __ ___ _ __ ___ ___ _ __ _ _ ",- " / _` |/ _` |/ _ \\ '_\\| __| ' \\/ -_) ' \\ _ \\ / _ \\| '__| | | | ",- "| (_| | (_| | __/ | || |_| | | \\___| | | | | | (_) | | | |_| | ",- " \\__,_|\\__, |\\___|_| \\__|_| |_| |_| |_| |_|\\___/|_| \\__, | ",- " |___/ |___/ ",+ " _ ",+ " __ _ __ _ ___ _ __ | |_ _ __ ___ ___ _ __ ___ ___ _ __ _ _ ",+ " / _` |/ _` |/ _ \\ '_ \\| __| '_ ` _ \\ / _ \\ '_ ` _ \\ / _ \\| '__| | | |",+ "| (_| | (_| | __/ | | | |_| | | | | | __/ | | | | | (_) | | | |_| |",+ " \\__,_|\\__, |\\___|_| |_|\\__|_| |_| |_|\\___|_| |_| |_|\\___/|_| \\__, |",+ " |___/ |___/ ",];const lines: string[] = ["", ...logo.map((line) => " " + accent(line))];lines.push("");diff --git a/website/components/Install.tsx b/website/components/Install.tsxindex 02d07588..e671aa8e 100644--- a/website/components/Install.tsx+++ b/website/components/Install.tsx@@ -12,22 +12,28 @@ interface Cmd {const SIMPLE: Cmd[] = [{- label: "1. START THE MEMORY SERVER",- cmd: "npx @agentmemory/agentmemory",- hint: "RUNS ON :3111 · VIEWER ON :3113",+ label: "1. INSTALL ONCE",+ cmd: "npm install -g @agentmemory/agentmemory",+ hint: "PUTS `agentmemory` ON YOUR PATH · STEPS 2/3 NEED THIS",},{- label: "2. SEE SEMANTIC RECALL INSTANTLY",- cmd: "npx @agentmemory/agentmemory demo",- hint: "SEEDS 3 SESSIONS · PROVES HYBRID SEARCH WORKS",+ label: "2. START THE MEMORY SERVER",+ cmd: "agentmemory",+ hint: "RUNS ON :3111 · VIEWER ON :3113",},{- label: "3. OPEN THE LIVE VIEWER",- cmd: "open http://localhost:3113",- hint: "SESSIONS · MEMORIES · GRAPH · HEALTH",+ label: "3. SEE SEMANTIC RECALL INSTANTLY",+ cmd: "agentmemory demo",+ hint: "SEEDS 3 SESSIONS · PROVES HYBRID SEARCH WORKS",},];+const NPX_FALLBACK: Cmd = {+ label: "PREFER ZERO-INSTALL? USE NPX",+ cmd: "npx @agentmemory/agentmemory",+ hint: "REPLACES STEPS 1+2 · USES NPX CACHE — SEE README FOR CAVEAT",+};+function CopyBox({ label, cmd, hint }: Cmd) {const [copied, setCopied] = useState(false);const [text, setText] = useState(hint);@@ -67,7 +73,7 @@ export function Install() {<header className="section-head"><span className="section-eyebrow">SHIP IT</span><h2 id="install-title" className="section-title">- THREE COMMANDS.<br />ANY AGENT.+ ONE INSTALL.<br />ANY AGENT.</h2><p className="section-lede">RUNS ON YOUR MACHINE. DATA STAYS LOCAL. BRING YOUR CLAUDE SUBSCRIPTION@@ -78,6 +84,7 @@ export function Install() {{SIMPLE.map((c) => (<CopyBox key={c.cmd} {...c} />))}+ <CopyBox {...NPX_FALLBACK} /><AgentInstall /></div><div className={styles.cta}>diff --git a/website/lib/generated-meta.json b/website/lib/generated-meta.jsonindex c6a52c6e..30ff1f46 100644--- a/website/lib/generated-meta.json+++ b/website/lib/generated-meta.json@@ -1,8 +1,8 @@{- "version": "0.9.10",+ "version": "0.9.15","mcpTools": 51,"hooks": 12,"restEndpoints": 121,- "testsPassing": 898,- "generatedAt": "2026-05-12T22:49:51.241Z"+ "testsPassing": 975,+ "generatedAt": "2026-05-15T16:48:13.498Z"}