+ Install •
Quick Start •
Benchmarks •
vs Competitors •
@@ -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).
+
+---
+
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/agentmemory@0.9.14` 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/Agents.tsx b/website/components/Agents.tsx
index f46990ef..664bea65 100644
--- a/website/components/Agents.tsx
+++ b/website/components/Agents.tsx
@@ -24,6 +24,16 @@ const FEATURED: Agent[] = [
pitch: "12 hooks + MCP + skills",
sub: "FIRST-CLASS PLUGIN",
},
+ {
+ id: "codex",
+ name: "Codex CLI",
+ from: "OpenAI",
+ logo: "https://github.com/openai.png",
+ accent: "#10A37F",
+ href: "https://github.com/openai/codex",
+ pitch: "6 hooks + MCP · native plugin",
+ sub: "NATIVE PLUGIN",
+ },
{
id: "openclaw",
name: "OpenClaw",
@@ -45,14 +55,24 @@ const FEATURED: Agent[] = [
sub: "FIRST-PARTY INTEGRATION",
},
{
- id: "codex",
- name: "Codex CLI",
- from: "OpenAI",
- logo: "https://github.com/openai.png",
- accent: "#10A37F",
- href: "https://github.com/openai/codex",
- pitch: "TOML mcp_servers · one-liner",
- sub: "MCP NATIVE",
+ id: "pi",
+ name: "pi",
+ from: "pi",
+ logo: "https://raw.githubusercontent.com/rohitg00/agentmemory/main/assets/agents/pi.svg",
+ accent: "#FF6B35",
+ href: "https://github.com/rohitg00/agentmemory/tree/main/integrations/pi",
+ pitch: "Native plugin + MCP",
+ sub: "NATIVE PLUGIN",
+ },
+ {
+ id: "openhuman",
+ name: "OpenHuman",
+ from: "tinyhumansai",
+ logo: "https://raw.githubusercontent.com/tinyhumansai/openhuman/main/app/src-tauri/icons/128x128.png",
+ accent: "#9b5cf6",
+ href: "https://github.com/tinyhumansai/openhuman",
+ pitch: "Native Memory trait backend (Rust)",
+ sub: "NATIVE BACKEND",
},
];
@@ -204,11 +224,12 @@ export function Agents() {
WORKS WITH
- FOUR FIRST-PARTY. REST MCP-NATIVE.
+ SIX FIRST-PARTY. REST MCP-NATIVE.
- AGENTMEMORY SHIPS PLUGINS FOR CLAUDE CODE, OPENCLAW, HERMES, AND
- CODEX. EVERY OTHER MCP CLIENT GETS IT FOR FREE.
+ NATIVE PLUGINS FOR CLAUDE CODE, CODEX CLI, OPENCLAW, HERMES, PI, AND
+ OPENHUMAN. EVERY OTHER MCP CLIENT GETS IT FOR FREE. `agentmemory
+ connect <agent>` AUTO-WIRES THEM ALL.
diff --git a/website/components/CommandCenter.tsx b/website/components/CommandCenter.tsx
index e738d22b..96a6bcbe 100644
--- a/website/components/CommandCenter.tsx
+++ b/website/components/CommandCenter.tsx
@@ -40,12 +40,12 @@ const PANELS: Record<
launch: "open http://localhost:3113",
},
console: {
- title: "iii CONSOLE · OPTIONAL",
+ title: "iii CONSOLE · FIRST-CLASS",
blurb:
- "agentmemory runs on the iii engine, so the official iii console gives you a deeper cut when you need it. Launch on :3114 so the viewer keeps :3113.",
+ "agentmemory runs on the iii engine, so the official iii console gives engine-level visibility: every function call, every worker, every queue, every trace. From v0.9.16 the agentmemory CLI prompts to install iii console alongside the engine. Launch on :3114 so the viewer keeps :3113.",
bullets: [
- "33 REGISTERED FUNCTIONS · INVOKE ANY DIRECTLY WITH JSON",
- "49 HTTP TRIGGERS · REPLAY REST ENDPOINTS",
+ "REGISTERED FUNCTIONS · INVOKE ANY DIRECTLY WITH JSON",
+ "107 HTTP ENDPOINTS · REPLAY ANY REST CALL",
"WEBSOCKET STREAM MONITOR · WATCH FRAMES LIVE",
"OTEL EXPORTER = MEMORY (DEFAULT) · TRACES STAY LOCAL",
"NO AUTH · BIND TO 127.0.0.1 ONLY",
@@ -101,8 +101,8 @@ export function CommandCenter() {
AGENTMEMORY SHIPS A REAL-TIME VIEWER FOR YOUR MEMORIES AND AN
- ENGINE-LEVEL CONSOLE FOR WHEN YOU WANT TO SEE EVERY FUNCTION, TRIGGER,
- AND OTEL SPAN.
+ ENGINE-LEVEL CONSOLE FOR EVERY FUNCTION, TRIGGER, AND OTEL SPAN.
+ BOTH ARE FIRST-CLASS — INSTALLED INLINE BY THE CLI ON FIRST RUN.
