Skip to content

#1 Persistent memory for AI coding agents based on real-world benchmarks

fix(cli): rerender splash banner + README npx caveat (#411)

Rohit Ghumare9344cfd502c1
diff --git a/README.md b/README.md
index 245dad27..4fbbea9b 100644
--- a/README.md
+++ b/README.md
@@ -53,6 +53,7 @@
</p>
<p align="center">
+ <a href="#install">Install</a> &bull;
<a href="#quick-start">Quick Start</a> &bull;
<a href="#benchmarks">Benchmarks</a> &bull;
<a href="#vs-competitors">vs Competitors</a> &bull;
@@ -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 demo
Open `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 Replay
Every 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.ts
index 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.tsx
index 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.json
index 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"
}