Skip to content

Commit b740473

Browse files
hongyi-chenoz-agent
andcommitted
docs(agent-memory): consolidate PR #95 content, move to top-level Memory section
Major restructure of the Agent Memory docs to address user feedback: 1. Promote Agent Memory to its own top-level section in the sidebar. New 'Memory (Research Preview)' group sits inside the Agents topic between Getting started and Warp Agents for top-of-list visibility. 2. Move the page from agent-platform/capabilities/agent-memory/ to agent-platform/agent-memory/ to match the new section's IA. The '/agent-platform/capabilities/agent-memory' URL now redirects to '/agent-platform/agent-memory/' via vercel.json. 3. Add '(Research Preview)' marker to the sidebar label, matching the page title and the existing Settings Sync (Beta) precedent. 4. Replace 'workspace' with 'team' in user-facing copy. The implementation-layer WORKSPACE enum is internal and unaffected. 5. Consolidate PR #95 (hyc/memory-waitlist) content into the page. PR #95 had been opened separately as a marketing/waitlist rewrite from another conversation. Taking its richer body (8 capability bullets, dedicated sections for Personal/team stores, Automatic memory from conversations with Sparse/Reasoned/Reversible sub-bullets, How agents retrieve memories with the Vector+BM25+Reranking pipeline, Attaching memory to agents covering identity-level and run-level attachments, and Built for teams), stronger CTAs (bold-link waitlist CTA after hero + 'Ready to give your agents memory?' closer), and richer 5-link related pages. Restores the research-preview caution callout that PR #95 had dropped, keeps the (Research Preview) title, and uses 'team' throughout. PR #95 will be closed in a follow-up. 6. Use generic 'agents' / 'your agents' / 'Warp agents' framing throughout. Memory is gated to cloud agents today but will work for local agents going forward, so the docs don't specify cloud vs local. The research-preview caution carries any 'behavior may change before GA' hedge. 7. Capability claims (deletion safety, per-store instructions, versioned history, hybrid semantic+keyword search) all match the QUALITY-585 and QUALITY-536 specs. Files touched: - src/content/docs/agent-platform/agent-memory/index.mdx (new) - src/content/docs/agent-platform/capabilities/agent-memory/index.mdx (deleted) - src/content/docs/agent-platform/capabilities/index.mdx (Agent Memory bullet removed) - src/content/docs/agent-platform/capabilities/skills.mdx (link URL updated) - src/sidebar.ts (new Memory group) - vercel.json (old URL redirect) Validation: - style_lint --changed: only the known pre-existing false positive on skills.mdx:414 Suggested Skills from Agent Memory header (both 'Skills' and 'Agent Memory' are proper feature names per AGENTS.md). - check_links --internal-only: 0 broken across 319 files and 2,422 internal links. New URL resolves cleanly. Co-Authored-By: Oz <oz-agent@warp.dev>
1 parent c8a6458 commit b740473

6 files changed

Lines changed: 100 additions & 52 deletions

File tree

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
---
2+
title: Agent Memory (Research Preview)
3+
description: >-
4+
Agent Memory gives your Warp agents persistent, searchable memory across
5+
conversations, so they remember team conventions, past decisions, and what
6+
you taught them.
7+
sidebar:
8+
label: "Agent Memory (Research Preview)"
9+
---
10+
:::caution
11+
Agent Memory is in **research preview** and is enabled per team for design partners. [Join the waitlist](https://warp.dev/oz/agent-memory#waitlist) to request access for your team.
12+
:::
13+
14+
Agent Memory is a persistent, cross-conversation memory layer for Warp agents. Instead of starting from scratch every run, your agents recall durable knowledge — team conventions, past decisions, deployment outcomes, your preferences — and apply it to the work in front of them. Each run begins further along than the last.
15+
16+
[**Join the Agent Memory waitlist →**](https://warp.dev/oz/agent-memory#waitlist)
17+
18+
## What you get with Agent Memory
19+
20+
* **Durable knowledge across conversations** — Agents remember what happened in previous runs and surface it as context for the current task.
21+
* **Personal and team memory stores** — Keep memories private to you, or share them across your team so every teammate and agent draws from the same well of knowledge.
22+
* **Automatic memory from conversations** — Warp extracts facts, learnings, and outcomes from finished conversations and writes them as memories, with a recorded reason for every change.
23+
* **Hybrid semantic and keyword search** — Memory retrieval combines vector similarity and full-text search, reranked for relevance, so the right memory surfaces even when wording shifts.
24+
* **Versioned history** — Every memory keeps its full version history. Older content is always recoverable, and updates record why the change was made.
25+
* **Per-agent access control and instructions** — Attach memory stores to an agent identity with read-only or read-write access, and write per-store instructions that tell the agent how and when to use each store.
26+
* **Cross-harness persistence** — Memories live on Warp, not inside any single agent harness, so the same knowledge follows your work across harnesses and triggers.
27+
* **Safe by default** — Memory stores in active use can't be accidentally deleted, so shared team knowledge can't disappear out from under live agents.
28+
29+
## Personal and team memory stores
30+
31+
A memory store is a named container for memories. Stores are owned by either a person or a team.
32+
33+
* **Personal stores** capture knowledge that's yours: preferences, working notes, individual patterns. Your agents draw from your personal store automatically.
34+
* **Team stores** capture shared knowledge: deployment runbooks, code review conventions, customer specifics, on-call procedures. Every team member and every agent the team authorizes can read from the same store.
35+
36+
Use multiple stores to keep contexts clean. A deploy bot has its own store for past deployments, a PR review bot has its own store for team conventions, and a customer-success agent has its own store for account histories.
37+
38+
## Automatic memory from conversations
39+
40+
You don't have to remember to save things. When a conversation finishes, Warp runs a memory synthesis pass that extracts durable facts, learnings, and outcomes from what happened, then writes them as memories.
41+
42+
* **Sparse by design.** Routine work produces nothing. Only meaningful, reusable knowledge becomes a memory.
43+
* **Reasoned.** Every create, update, or delete records the reason — so future you can see why a memory exists.
44+
* **Reversible.** Synthesis can merge new knowledge into existing memories, supersede outdated ones, or tombstone memories that no longer hold. Older versions remain in history if you need to look back.
45+
46+
You can also explicitly tell Warp to remember something during a conversation, and it lands in the right store with the right context.
47+
48+
## How agents retrieve memories
49+
50+
When an agent starts a task, Warp searches its accessible memory stores for relevant context and injects what it finds. The retrieval pipeline runs every query through:
51+
52+
1. **Vector search** for semantic similarity, even when the agent's wording doesn't match the memory's wording exactly.
53+
2. **Keyword (BM25) search** for exact terms, names, IDs, and identifiers that matter to your work.
54+
3. **Reranking** to score the combined results and pick the few most relevant memories for the task.
55+
56+
The agent sees those memories alongside the rest of its context, just like rules and Codebase Context. You don't have to write retrieval queries or pre-load memory by hand.
57+
58+
## Attaching memory to your agents
59+
60+
You decide which agents can read from which stores.
61+
62+
* **Attach a store to an agent identity** to give a named agent durable access across every one of its runs. Pair it with **read-only** or **read-write** access and free-form **instructions** that tell the agent how to use the store — for example, "Reference this store for team naming conventions" or "Write a new memory after each successful deployment."
63+
* **Attach a store to a single run** when you want to augment one task without changing the agent's permanent setup. Run-level attachments are additive on top of the agent identity's stores, and they win on conflict if you want to override access or instructions for that run.
64+
65+
Instructions matter. They're how you turn raw storage into a useful tool — the difference between an agent that "has memory" and an agent that knows what to remember and when.
66+
67+
## Built for teams
68+
69+
Agent Memory is designed to be shared.
70+
71+
* **Team-owned stores** are accessible to every member of the team and to the agents the team authorizes, so the whole team builds on the same knowledge base.
72+
* **Personal stores** stay private. Your memories are yours.
73+
* **Authorization is explicit.** Stores have to be attached to an agent before that agent can read or write. Nothing is implicit, and you can audit which agents touch which stores.
74+
* **Deletion safety.** A store with active agent attachments can't be deleted. If you try, Warp tells you which agents are still using it, so shared memory can't quietly vanish.
75+
76+
## Ready to give your agents memory?
77+
78+
Stop watching agents re-learn the same things every run. With Agent Memory, what your agents learn today makes them sharper tomorrow.
79+
80+
[**Join the Agent Memory waitlist →**](https://warp.dev/oz/agent-memory#waitlist)
81+
82+
## Related pages
83+
84+
* [Codebase Context](/agent-platform/capabilities/codebase-context/) — Let agents understand your codebase through semantic indexing.
85+
* [Rules](/agent-platform/capabilities/rules/) — Define global and project-level guidelines that shape agent behavior.
86+
* [Skills](/agent-platform/capabilities/skills/) — Reusable, scoped instructions that teach agents how to perform specific tasks.
87+
* [Agent profiles and permissions](/agent-platform/capabilities/agent-profiles-permissions/) — Control what permissions and autonomy agents have.
88+
* [Cloud agents overview](/agent-platform/cloud-agents/overview/) — Run background agents with team-wide observability.

src/content/docs/agent-platform/capabilities/agent-memory/index.mdx

Lines changed: 0 additions & 50 deletions
This file was deleted.

src/content/docs/agent-platform/capabilities/index.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,6 @@ Understanding these capabilities helps you get the most out of agents by configu
2121
* [Computer Use](/agent-platform/capabilities/computer-use/) - Let agents interact with desktop environments by taking screenshots, clicking, typing, and controlling the GUI.
2222
* [MCP](/agent-platform/capabilities/mcp/) - Connect external data sources and tools to Warp's agents via the Model Context Protocol.
2323
* [Codebase Context](/agent-platform/capabilities/codebase-context/) - Let agents understand your codebase through semantic indexing of your Git-tracked files.
24-
* [Agent Memory](/agent-platform/capabilities/agent-memory/) - Persistent, cross-harness memory layer that lets cloud agents carry context from one run to the next (research preview).
2524
* [Agent Profiles & Permissions](/agent-platform/capabilities/agent-profiles-permissions/) - Control what permissions and autonomy agents have to run commands and apply changes.
2625
* [Web Search](/agent-platform/capabilities/web-search/) - Allow agents to search the web for up-to-date information.
2726

src/content/docs/agent-platform/capabilities/skills.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -413,7 +413,7 @@ These same skills also appear as suggested agents in the [Oz web app](/agent-pla
413413

414414
## Suggested Skills from Agent Memory
415415

416-
Promoting recurring patterns from [Agent Memory](/agent-platform/capabilities/agent-memory/) into reviewable skill drafts is in design as part of the research preview. See the Agent Memory page for current status.
416+
Promoting recurring patterns from [Agent Memory](/agent-platform/agent-memory/) into reviewable skill drafts is in design as part of the research preview. See the Agent Memory page for current status.
417417

418418
## Invoking skills with a prompt
419419

src/sidebar.ts

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -246,6 +246,12 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
246246
'agent-platform/getting-started/faqs',
247247
],
248248
},
249+
{
250+
label: 'Memory (Research Preview)',
251+
items: [
252+
{ slug: 'agent-platform/agent-memory', label: 'Agent Memory' },
253+
],
254+
},
249255
{
250256
label: 'Warp Agents',
251257
items: [

vercel.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9572,6 +9572,11 @@
95729572
"source": "/oz",
95739573
"destination": "/agent-platform/cloud-agents/overview/",
95749574
"statusCode": 308
9575+
},
9576+
{
9577+
"source": "/agent-platform/capabilities/agent-memory",
9578+
"destination": "/agent-platform/agent-memory/",
9579+
"statusCode": 308
95759580
}
95769581
]
95779582
}

0 commit comments

Comments
 (0)