docs(readme): show how to extend agentmemory with iii workers

[rohitg00]

Summary

• Promote the iii console to its own README section so users can find it without scrolling through the viewer block.
• Add an Extend with one command section that maps each iii worker add <name> to a concrete agentmemory capability: multi-instance memory, scheduled consolidation, durable retries, sandboxed code exec, SQL state, extra MCP host.
• Drop the buried "Architecture" footer and roll the stack-replacement table into the new section.

What's new on the README

iii worker add	Capability on top of agentmemory
iii-pubsub	Multi-instance memory — fan out writes, union reads
iii-cron	Scheduled consolidation, decay sweeps, snapshot rotation
iii-queue	Durable retries for embedding + compression jobs
iii-observability	OTEL traces on every memory op (default on)
iii-sandbox	Run recalled code inside a microVM, not the shell
iii-database	SQL-backed state adapter
mcp	Extra MCP host alongside agentmemory's

Every entry links to its page on workers.iii.dev, so users can install and see new functions appear in the viewer + console without any further config.

Test plan

• Render README on github.com/rohitg00/agentmemory and confirm anchors (#iii-console, #powered-by-iii) resolve.
• Confirm every iii worker add worker name resolves at https://workers.iii.dev/workers/<name>.
• Sanity-check headings on mobile width.

Summary by CodeRabbit

• Documentation
  • Reorganized navigation to surface "iii Console" and "Powered by iii"
  • Rewrote iii Console content to contrast viewer vs. console with concrete examples (tracing, KV edits, hook replay, stream pinning)
  • Added "Powered by iii" overview and worker capability guidance
  • Removed prior architecture section for clearer focus

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agentmemory	Ready	Preview, Comment	May 8, 2026 4:43pm

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 301eba07-5e4a-4482-be5a-2ec569b1cff6

📥 Commits

Reviewing files that changed from the base of the PR and between 6be98d2 and 6930c4f.

📒 Files selected for processing (1)

• README.md

---

📝 Walkthrough

Walkthrough

README navigation and content are reorganized: hero and TOC links updated, the iii-console section rewritten to contrast viewer vs console with examples, a new "Powered by iii" section documents worker-based extensibility, and the prior architecture section is removed.

Changes

Documentation Restructure

Layer / File(s)	Summary
Navigation Header & Hero Update README.md	Hero tagline linked to "Built on iii engine"; TOC splits "iii Console — trace-level engine inspection" into separate "iii Console" and "Powered by iii" links.
iii Console Section Rewrite README.md	iii-console content rewritten to contrast viewer (what the agent remembered) vs console (what the agent did), with examples: tracing waterfalls, stream pinning, KV editing, and hook replay.
Powered by iii Section Addition README.md	New section describing agentmemory as an already-running iii instance, documents iii worker add extension options, includes worker→capability mapping and a "What iii replaces" comparison table.
Architecture Section Removal README.md	Removed the prior "architecture" section that explained iii-engine primitives and listed what iii-engine replaces.

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant Viewer
  participant iiiConsole
  User->>Viewer: inspect remembered state
  User->>iiiConsole: trace agent actions / replay hooks
  iiiConsole->>User: show streams, allow edits/pinning

Loading

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly Related PRs

• rohitg00/agentmemory#5: Documentation rewrites reorganizing README navigation and sections.
• rohitg00/agentmemory#157: Overlapping edits to iii Console documentation and trace-level examples.
• rohitg00/agentmemory#242: Directly related edits modifying the same README sections and tables.

Poem

🐰 I hop through docs anew,
Links split and sections bloom,
The console shows what the agent did,
Workers hum and add their tune,
Docs shine bright beneath the moon.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title 'docs(readme): show how to extend agentmemory with iii workers' accurately summarizes the main change: adding documentation on extending agentmemory with iii workers. It directly matches the primary objective of promoting the iii console section and documenting worker extensibility.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/extend-with-iii-workers

⚔️ Resolve merge conflicts

• Resolve merge conflict in branch docs/extend-with-iii-workers

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}