diff --git a/website/app/page.tsx b/website/app/page.tsx
index a321d6d667..16a0ab89a8 100644
--- a/website/app/page.tsx
+++ b/website/app/page.tsx
@@ -8,6 +8,8 @@ import { ContextFunnel } from "@/components/site/ContextFunnel";
import { InfraTiles } from "@/components/site/InfraTiles";
import { MemoryScroll } from "@/components/site/MemoryScroll";
import { Benchmarks } from "@/components/site/Benchmarks";
+import { Runtime } from "@/components/site/Runtime";
+import { Scale } from "@/components/site/Scale";
import { Agents } from "@/components/site/Agents";
import { LocalFirst } from "@/components/site/LocalFirst";
import { Interfaces } from "@/components/site/Interfaces";
@@ -27,11 +29,13 @@ export default function Page() {
+
+
diff --git a/website/components/site/Runtime.module.css b/website/components/site/Runtime.module.css
new file mode 100644
index 0000000000..340152f8d0
--- /dev/null
+++ b/website/components/site/Runtime.module.css
@@ -0,0 +1,209 @@
+.figure {
+ display: grid;
+ grid-template-columns: minmax(0, 1.6fr) minmax(0, 1fr);
+ gap: var(--s-5);
+ align-items: stretch;
+}
+
+.term {
+ border: 1px solid var(--ink);
+ border-radius: var(--radius-lg);
+ background: #0b0b0b;
+ color: #f2f2f2;
+ overflow: hidden;
+ box-shadow: var(--shadow);
+ min-width: 0;
+}
+
+.termHead {
+ display: flex;
+ align-items: center;
+ gap: var(--s-3);
+ padding: var(--s-3) var(--s-4);
+ border-bottom: 1px solid rgba(255, 255, 255, 0.12);
+ font-size: var(--t-12);
+ color: rgba(250, 250, 250, 0.6);
+}
+
+.lights {
+ display: inline-flex;
+ gap: 6px;
+}
+
+.lights span {
+ width: 9px;
+ height: 9px;
+ border-radius: 50%;
+ background: rgba(250, 250, 250, 0.22);
+}
+
+.lines {
+ list-style: none;
+ margin: 0;
+ padding: var(--s-4);
+ display: grid;
+ gap: var(--s-4);
+}
+
+.line {
+ display: grid;
+ gap: 4px;
+ min-width: 0;
+}
+
+:global(.js) .line {
+ opacity: 0;
+ transform: translateY(6px);
+}
+
+:global(.is-in) .line {
+ opacity: 1;
+ transform: none;
+ transition: opacity 500ms var(--ease-out), transform 500ms var(--ease-out);
+ transition-delay: calc(var(--i) * 140ms);
+}
+
+.cmd {
+ font-size: var(--t-14);
+ color: #f2f2f2;
+ overflow-wrap: anywhere;
+ background: none;
+ padding: 0;
+}
+
+.dollar {
+ color: var(--accent);
+ margin-right: 0.6em;
+ user-select: none;
+}
+
+.out {
+ font-size: var(--t-12);
+ color: rgba(250, 250, 250, 0.62);
+ padding-left: 1.4em;
+ line-height: 1.5;
+}
+
+.stack {
+ border: 1px solid var(--line-2);
+ border-radius: var(--radius-lg);
+ background: var(--surface);
+ padding: var(--s-5);
+ display: flex;
+ flex-direction: column;
+ gap: var(--s-4);
+ min-width: 0;
+}
+
+.stackHead {
+ font-size: var(--t-12);
+ color: var(--muted);
+ letter-spacing: var(--track-mono);
+ text-transform: uppercase;
+}
+
+.layers {
+ list-style: none;
+ margin: 0;
+ padding: 0;
+ display: grid;
+ gap: var(--s-2);
+}
+
+.layer {
+ display: grid;
+ grid-template-columns: minmax(0, 1fr) auto;
+ gap: 2px var(--s-3);
+ padding: var(--s-3);
+ border: 1px solid var(--line);
+ border-left: 3px solid var(--ink);
+ border-radius: var(--radius);
+ background: var(--bg);
+}
+
+:global(.js) .layer {
+ opacity: 0;
+ transform: translateX(8px);
+}
+
+:global(.is-in) .layer {
+ opacity: 1;
+ transform: none;
+ transition: opacity 500ms var(--ease-out), transform 500ms var(--ease-out);
+ transition-delay: calc(500ms + var(--i) * 120ms);
+}
+
+.layer:first-child {
+ border-left-color: var(--accent);
+}
+
+.layerName {
+ font-weight: 600;
+ font-size: var(--t-14);
+}
+
+.layerSub {
+ font-size: var(--t-12);
+ color: var(--ink);
+ text-align: right;
+}
+
+.layerNote {
+ grid-column: 1 / -1;
+ font-size: var(--t-12);
+ color: var(--muted);
+}
+
+.stackFoot {
+ margin: auto 0 0;
+ font-size: var(--t-12);
+ color: var(--muted);
+ line-height: 1.5;
+}
+
+.nowrap {
+ white-space: nowrap;
+}
+
+.facts {
+ list-style: none;
+ margin: var(--s-6) 0 0;
+ padding: 0;
+ display: grid;
+ grid-template-columns: repeat(3, minmax(0, 1fr));
+ gap: var(--s-5);
+}
+
+.facts li {
+ display: grid;
+ gap: var(--s-2);
+ color: var(--ink-2);
+ font-size: var(--t-14);
+ line-height: var(--lh-body);
+}
+
+.facts li > .mono,
+.facts li > span:first-child {
+ font-size: var(--t-12);
+ color: var(--muted);
+ letter-spacing: var(--track-mono);
+ text-transform: uppercase;
+}
+
+@media (max-width: 900px) {
+ .figure {
+ grid-template-columns: minmax(0, 1fr);
+ }
+
+ .facts {
+ grid-template-columns: minmax(0, 1fr);
+ }
+}
+
+@media (prefers-reduced-motion: reduce) {
+ :global(.js) .line,
+ :global(.js) .layer {
+ opacity: 1;
+ transform: none;
+ }
+}
diff --git a/website/components/site/Runtime.tsx b/website/components/site/Runtime.tsx
new file mode 100644
index 0000000000..eea6a29801
--- /dev/null
+++ b/website/components/site/Runtime.tsx
@@ -0,0 +1,115 @@
+import { INSTALL_CMD } from "@/lib/site";
+import { Reveal } from "./client";
+import s from "./Runtime.module.css";
+
+const SESSION = [
+ { cmd: INSTALL_CMD, out: "installs the pinned iii engine on macOS, Linux or Windows, then starts Worker Compose" },
+ { cmd: "agentmemory connect claude-code", out: "wires MCP and capture hooks into the agent you pick" },
+ { cmd: "agentmemory demo --serve", out: "seeds sample sessions, shows recall, then stops the server it started" },
+ { cmd: "agentmemory doctor", out: "finds config problems and offers a fix for each one" },
+ { cmd: "agentmemory status", out: "health, memory count, feature flags and anything that needs attention" },
+];
+
+const STACK = [
+ { name: "iii engine", sub: "127.0.0.1:49134", note: "pinned version, checksum verified" },
+ { name: "state worker", sub: "file state", note: "your data directory" },
+ { name: "http worker", sub: "REST :3111", note: "bearer secret made on first start" },
+ { name: "agentmemory worker", sub: "capture, search, graph", note: "viewer on :3113" },
+];
+
+const FACTS = [
+ {
+ key: "keys",
+ text: "None needed. Capture, keyword and graph search run on your machine. LLM features and cloud embeddings start only when you name a provider.",
+ },
+ {
+ key: "service",
+ text: "Keep it running after logout with the systemd and launchd recipes, or one Docker Compose file.",
+ href: "/docs/deployment",
+ link: "deployment guide",
+ },
+ {
+ key: "undo",
+ text: "agentmemory remove shows a plan, unwires every agent it connected and keeps your memory data unless you say otherwise.",
+ },
+];
+
+export function Runtime() {
+ return (
+
+
+
+
Developer experience
+
One command runs the whole memory stack.
+
+ No database to provision, no account, no Docker required. The CLI installs the runtime it needs, starts it on
+ loopback, wires your agents and tells you in plain words when something is off.
+
+
+
+
+
+
+
+
+
+
+
+ ~/project
+
+
+ {SESSION.map((l, i) => (
+ -
+
+
+ $
+
+ {l.cmd}
+
+ {l.out}
+
+ ))}
+
+
+
+
+
+ started by that first command
+
+
+ {STACK.map((w, i) => (
+ -
+ {w.name}
+ {w.sub}
+ {w.note}
+
+ ))}
+
+
+ one Worker Compose project per instance; --instance 1 runs a second one beside it
+
+
+
+
+
+ {FACTS.map((f) => (
+ -
+ {f.key}
+
+ {f.text}
+ {f.href ? (
+ <>
+ {" "}
+
+ {f.link}
+
+ >
+ ) : null}
+
+
+ ))}
+
+
+
+ );
+}
diff --git a/website/components/site/Scale.module.css b/website/components/site/Scale.module.css
new file mode 100644
index 0000000000..b6a2ef5ac4
--- /dev/null
+++ b/website/components/site/Scale.module.css
@@ -0,0 +1,193 @@
+.figure {
+ border: 1px solid var(--ink);
+ border-radius: var(--radius-lg);
+ background: var(--surface);
+ padding: var(--s-5);
+ display: grid;
+ gap: var(--s-4);
+ box-shadow: var(--shadow);
+}
+
+.figHead {
+ display: flex;
+ justify-content: space-between;
+ align-items: baseline;
+ gap: var(--s-3);
+ font-size: var(--t-12);
+ color: var(--muted);
+ letter-spacing: var(--track-mono);
+ text-transform: uppercase;
+}
+
+.figHead .src {
+ text-transform: none;
+ letter-spacing: 0;
+}
+
+.lane {
+ display: grid;
+ grid-template-columns: 9rem minmax(0, 1fr);
+ gap: var(--s-4);
+ align-items: center;
+}
+
+.laneLabel {
+ font-size: var(--t-12);
+ color: var(--muted);
+}
+
+.after .laneLabel {
+ color: var(--ink);
+ font-weight: 600;
+}
+
+.steps {
+ list-style: none;
+ margin: 0;
+ padding: 0;
+ display: grid;
+ grid-template-columns: repeat(3, minmax(0, 1fr));
+ gap: var(--s-5);
+ position: relative;
+}
+
+.step {
+ position: relative;
+ display: grid;
+ gap: 4px;
+ padding: var(--s-3);
+ border: 1px solid var(--line-2);
+ border-radius: var(--radius);
+ background: var(--bg);
+ min-width: 0;
+}
+
+.step + .step::before {
+ content: "";
+ position: absolute;
+ top: 50%;
+ left: calc(-1 * var(--s-5));
+ width: var(--s-5);
+ height: 1px;
+ background: var(--line-2);
+}
+
+.after .step {
+ border-color: var(--ink);
+}
+
+.after .step + .step::before {
+ background: var(--ink);
+}
+
+:global(.js) .step {
+ opacity: 0;
+ transform: translateY(6px);
+}
+
+:global(.is-in) .step {
+ opacity: 1;
+ transform: none;
+ transition: opacity 500ms var(--ease-out), transform 500ms var(--ease-out);
+ transition-delay: calc(var(--i) * 140ms);
+}
+
+:global(.is-in) .after .step {
+ transition-delay: calc(500ms + var(--i) * 140ms);
+}
+
+.stepName {
+ font-size: var(--t-14);
+ background: none;
+ padding: 0;
+ overflow-wrap: anywhere;
+}
+
+.stepNote {
+ font-size: var(--t-12);
+ color: var(--muted);
+ line-height: 1.45;
+}
+
+.bad .stepName {
+ color: var(--muted);
+ text-decoration: line-through;
+ text-decoration-color: var(--faint);
+}
+
+.good {
+ border-color: var(--accent) !important;
+ background: var(--accent-soft);
+}
+
+.good .stepName {
+ color: var(--accent-ink);
+ font-weight: 600;
+}
+
+.gains {
+ list-style: none;
+ margin: var(--s-6) 0 0;
+ padding: 0;
+ display: grid;
+ grid-template-columns: repeat(3, minmax(0, 1fr));
+ gap: var(--s-5);
+}
+
+.gain {
+ display: grid;
+ align-content: start;
+ gap: var(--s-2);
+ padding-top: var(--s-4);
+ border-top: 1px solid var(--line-2);
+}
+
+.gain h3 {
+ margin: 0;
+ font-size: var(--t-16);
+ line-height: var(--lh-snug);
+}
+
+.gain p {
+ margin: 0;
+ color: var(--ink-2);
+ font-size: var(--t-14);
+ line-height: var(--lh-body);
+}
+
+.version {
+ font-size: var(--t-12);
+ color: var(--muted);
+}
+
+@media (max-width: 900px) {
+ .gains {
+ grid-template-columns: minmax(0, 1fr);
+ }
+
+ .lane {
+ grid-template-columns: minmax(0, 1fr);
+ gap: var(--s-2);
+ }
+}
+
+@media (max-width: 640px) {
+ .steps {
+ grid-template-columns: minmax(0, 1fr);
+ gap: var(--s-3);
+ }
+
+ .step + .step::before {
+ top: calc(-1 * var(--s-3));
+ left: var(--s-4);
+ width: 1px;
+ height: var(--s-3);
+ }
+}
+
+@media (prefers-reduced-motion: reduce) {
+ :global(.js) .step {
+ opacity: 1;
+ transform: none;
+ }
+}
diff --git a/website/components/site/Scale.tsx b/website/components/site/Scale.tsx
new file mode 100644
index 0000000000..6e0cfce8bd
--- /dev/null
+++ b/website/components/site/Scale.tsx
@@ -0,0 +1,123 @@
+import { REPO_URL } from "@/lib/site";
+import { Reveal } from "./client";
+import s from "./Scale.module.css";
+
+const pr = (n: number) => `${REPO_URL}/pull/${n}`;
+
+const BEFORE = [
+ { step: "state::list", note: "whole scope in one message" },
+ { step: "16 MiB frame", note: "worker transport limit" },
+ { step: "payload_too_large", note: "a big store looked empty", bad: true },
+];
+
+const AFTER = [
+ { step: "state::list_keys", note: "keys first, then records in pages" },
+ { step: "64 MiB frame", note: "60 MiB payload guard below it" },
+ { step: "every record", note: "scopes past 64 MiB keep working", good: true },
+];
+
+const GAINS = [
+ {
+ version: "0.9.33",
+ title: "Recall keeps every strong match",
+ text: "Saved memories are no longer capped at three per search, and keyword and vector search each pass at least 40 candidates into fusion.",
+ href: pr(1696),
+ ref: "#1696",
+ },
+ {
+ version: "0.9.33",
+ title: "Long calls finish",
+ text: "The MCP shim no longer cuts proxied calls off at 15 s. It waits 190 s, past the 180 s server limit, so consolidate and reflect complete on large stores.",
+ href: pr(1691),
+ ref: "#1691",
+ },
+ {
+ version: "0.9.33",
+ title: "Bounded reflection",
+ text: "Reflection reads lessons and crystals in pages and caps the evidence and insight it returns.",
+ href: pr(1544),
+ ref: "#1544",
+ },
+ {
+ version: "0.9.33",
+ title: "Lean indexes",
+ text: "Evicted memories leave the keyword and vector indexes, and boot finds gaps in a partly embedded vector index.",
+ href: pr(1601),
+ ref: "#1601, #1687",
+ },
+ {
+ version: "0.9.31",
+ title: "Incremental summaries",
+ text: "Summaries cover only what was captured since the last run. A session end with nothing new costs no LLM call.",
+ href: `${REPO_URL}/blob/main/CHANGELOG.md`,
+ ref: "changelog",
+ },
+ {
+ version: "0.9.31",
+ title: "Graph never stalls a search",
+ text: "Graph enrichment gets 500 ms. When it runs out, keyword and vector results return without it.",
+ href: `${REPO_URL}/blob/main/docs/reliability/graph-search-budget.md`,
+ ref: "search budget",
+ },
+];
+
+function Lane({ label, rows, tone }: { label: string; rows: { step: string; note: string; bad?: boolean; good?: boolean }[]; tone: "before" | "after" }) {
+ return (
+
+
{label}
+
+ {rows.map((r, i) => (
+ -
+
{r.step}
+ {r.note}
+
+ ))}
+
+
+ );
+}
+
+export function Scale() {
+ return (
+
+ );
+}
diff --git a/website/lib/llms.ts b/website/lib/llms.ts
index 865ed299cd..8fcf0c80ac 100644
--- a/website/lib/llms.ts
+++ b/website/lib/llms.ts
@@ -79,6 +79,15 @@ export function llmsFullTxt(): string {
MCP_JSON,
"```",
"",
+ "## Operate",
+ "",
+ "- `agentmemory demo --serve` seeds sample sessions, shows recall and stops the server it started.",
+ "- `agentmemory doctor` finds configuration problems and offers a fix for each one.",
+ "- `agentmemory status` reports health, memory count and feature flags.",
+ "- `agentmemory stop` stops the runtime; `agentmemory remove` undoes agent connections and keeps memory data by default.",
+ "- No API key is needed. LLM features and cloud embeddings run only when `AGENTMEMORY_LLM_PROVIDER` or `EMBEDDING_PROVIDER` names a provider.",
+ `- Run it as a background service with the systemd and launchd recipes in ${SITE_URL}/docs/deployment.`,
+ "",
"## How it works",
"",
"1. Capture. Hooks fire on every prompt and tool call. Each event is posted to the local server on port 3111 with a restart-safe id, or spooled to disk if the server is down.",
@@ -97,6 +106,13 @@ export function llmsFullTxt(): string {
"",
...others.map(agentLine),
"",
+ "## Performance",
+ "",
+ "- State reads page through keys, and the worker transport limit is 64 MiB, so memory scopes larger than 64 MiB keep loading (0.9.33).",
+ "- Saved memories are no longer capped at three per search; keyword and vector search each pass at least 40 candidates into fusion (0.9.33).",
+ "- The MCP shim waits 190 s for proxied calls, past the 180 s server limit, so long consolidate and reflect calls finish (0.9.33).",
+ "- Summaries are incremental, and graph enrichment has a 500 ms budget before keyword and vector results return without it (0.9.31).",
+ "",
"## Benchmarks",
"",
summary.longmemeval,
diff --git a/website/lib/site.ts b/website/lib/site.ts
index 93ee0c6722..4c95874662 100644
--- a/website/lib/site.ts
+++ b/website/lib/site.ts
@@ -213,7 +213,7 @@ export const FAQ = [
},
{
q: "Do I need an API key?",
- a: "No. Keyless mode works out of the box with BM25 recall. Set EMBEDDING_PROVIDER=local for free on-device semantic recall, or add a provider key for LLM consolidation.",
+ a: "No. Keyless mode works out of the box with BM25 and graph recall. Set EMBEDDING_PROVIDER=local for free on-device semantic recall. For LLM consolidation, set AGENTMEMORY_LLM_PROVIDER and that provider's key; a key alone sends nothing out.",
},
{
q: "Which agents does it work with?",