docs(readme): correct iii console install + launch commands by rohitg00 · Pull Request #243 · rohitg00/agentmemory

rohitg00 · 2026-05-08T16:50:52Z

Summary

The iii console ships with iii and is launched as a subcommand. The README's install + launch commands referenced a separate installer and a iii-console binary that don't exist — fixed against the canonical reference at https://iii.dev/docs/console.

Changes

Drop the bogus install line. No curl install.iii.dev/console/main/install.sh — the console is preinstalled with iii.
Use iii console, not iii-console. It's a subcommand of iii.
Simplify the launch command. A default agentmemory setup only needs iii console --port 3114 (the viewer holds 3113). Engine-port, ws-port, and bridge-port match agentmemory defaults — show them as overrides only.
Mention --enable-flow for the experimental architecture-graph page.
Add missing console pages to the capability table: Workers, Queues, Config, Flow.

Verified against

iii console --help (real flags + defaults)
https://iii.dev/docs/console (install, launch, sidebar pages)

Test plan

iii console --port 3114 launches the console on a machine where agentmemory is running on default ports.
All pages listed in the capability table appear in the sidebar.
Render README on github.com/rohitg00/agentmemory and confirm the new commands display correctly.

Summary by CodeRabbit

Documentation

Updated console documentation to reflect that it ships with iii installation
Expanded console capabilities documentation to include Workers, Queues, States, Streams, Config, and Flow pages

The console ships with `iii` and is launched as a subcommand, not via a separate installer or `iii-console` binary. Update the README to use the real surface from iii.dev/docs/console: - Drop the bogus `install.iii.dev/console` curl line — there is no separate installer. - Replace `iii-console ...` with `iii console --port 3114`. Port flag is enough on a default agentmemory setup; engine-port, ws-port, and bridge-port are documented as overrides. - Mention `--enable-flow` for the experimental architecture-graph page. - Add the missing console pages to the capability table: Workers, Queues, Config, Flow.

vercel · 2026-05-08T16:50:56Z

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:50pm

coderabbitai · 2026-05-08T16:51:16Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: e700205b-182e-4956-9214-2662c3555bbe

📥 Commits

Reviewing files that changed from the base of the PR and between 69472ee and e39f09f.

📒 Files selected for processing (1)

README.md

📝 Walkthrough

Walkthrough

README.md documentation for the iii-console section is updated to remove standalone installation instructions (console now ships with iii), simplify launch wording, and expand the capability reference table to document additional console pages including Workers, Queues, Config, and optional Flow features.

Changes

Console Documentation

Layer / File(s)	Summary
Console Setup and Capabilities `README.md`	Removed standalone console install step; revised launch instructions and expanded "What you can do from the console" table to enumerate Workers, Queues, Config, and Flow alongside existing Functions, Triggers, States, Streams, Traces, and Logs.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

rohitg00/agentmemory#242: Both PRs modify the README's iii-console documentation and reorganize console-related content in overlapping documentation sections.
rohitg00/agentmemory#157: Both PRs update README documentation about the iii console and its capabilities/pages.

Poem

🐰 The console ships with iii now in place,
No install step clutters the docs' grace,
Workers and Queues take the stage with flair,
Config and Flow float through the air! 📚✨

🚥 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 accurately describes the main changes: correcting incorrect iii console install and launch commands in the README documentation.
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/fix-iii-console-commands

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

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

@Nizar-BenHamida

Bug-fix patch focused on search recall correctness and plugin compatibility. Pins iii-engine to v0.11.2 because v0.11.6 introduces a new sandbox-everything-via-`iii worker add` model that agentmemory hasn't been refactored for yet — pin lifts once that refactor lands. Adds a hard guard against silent vector-index corruption, fixes BM25 indexing for memories saved via memory_save, and lands four Hermes plugin fixes. Per AGENTS.md release checklist: - package.json version 0.9.4 -> 0.9.5 - src/version.ts VERSION constant - src/types.ts ExportData version union - src/functions/export-import.ts supportedVersions Set - test/export-import.test.ts assertion - plugin/.claude-plugin/plugin.json version - CHANGELOG.md detailed entries with contributor shoutouts Headlines (full detail in CHANGELOG): Fixed: - BM25 search now indexes memories saved via memory_save (#258, #257) Thanks @Nizar-BenHamida for the precise repro. - Embedding providers no longer silently corrupt the vector index when an API returns wrong-dimension vectors (#248, #247, #256) Thanks @AmmarSaleh50 for issue + fix + tests. - Hermes handle_tool_call returns JSON strings, not raw dicts (#255, #254) Thanks @KyoMio for the Anthropic-protocol repro. - Hermes status reflects real service state on systemd installs (#253, #250) Thanks @OptionalCoin for tracing it to env-source divergence. - Hermes hooks accept passthrough kwargs (#252, #249) Thanks @OptionalCoin again for the log analysis. - agentmemory demo now seeds observations correctly (#251, #229) Thanks @seishonagon for root-cause analysis. - LLM compression / summarization timeouts increased (#213) Thanks @xuli500177. - Pi / OpenClaw / Hermes integration plugin fixes (#230) Thanks @deepmroot. Changed: - iii-engine pinned to v0.11.2 across every install path (#260). v0.11.6 introduces a new `iii worker add` sandbox model that agentmemory still pre-dates; pin lifts when we refactor agentmemory to register as a sandboxed worker. Override with AGENTMEMORY_III_VERSION=<version> for users who've migrated manually. - README documents iii worker add extension surface (#242). - README iii Console install/launch commands corrected (#243). Validated: 852/852 tests pass, npm run build clean.

@Nizar-BenHamida

Bug-fix patch focused on search recall correctness and plugin compatibility. Pins iii-engine to v0.11.2 because v0.11.6 introduces a new sandbox-everything-via-`iii worker add` model that agentmemory hasn't been refactored for yet — pin lifts once that refactor lands. Adds a hard guard against silent vector-index corruption, fixes BM25 indexing for memories saved via memory_save, and lands four Hermes plugin fixes. Per AGENTS.md release checklist: - package.json version 0.9.4 -> 0.9.5 - src/version.ts VERSION constant - src/types.ts ExportData version union - src/functions/export-import.ts supportedVersions Set - test/export-import.test.ts assertion - plugin/.claude-plugin/plugin.json version - CHANGELOG.md detailed entries with contributor shoutouts Headlines (full detail in CHANGELOG): Fixed: - BM25 search now indexes memories saved via memory_save (#258, #257) Thanks @Nizar-BenHamida for the precise repro. - Embedding providers no longer silently corrupt the vector index when an API returns wrong-dimension vectors (#248, #247, #256) Thanks @AmmarSaleh50 for issue + fix + tests. - Hermes handle_tool_call returns JSON strings, not raw dicts (#255, #254) Thanks @KyoMio for the Anthropic-protocol repro. - Hermes status reflects real service state on systemd installs (#253, #250) Thanks @OptionalCoin for tracing it to env-source divergence. - Hermes hooks accept passthrough kwargs (#252, #249) Thanks @OptionalCoin again for the log analysis. - agentmemory demo now seeds observations correctly (#251, #229) Thanks @seishonagon for root-cause analysis. - LLM compression / summarization timeouts increased (#213) Thanks @xuli500177. - Pi / OpenClaw / Hermes integration plugin fixes (#230) Thanks @deepmroot. Changed: - iii-engine pinned to v0.11.2 across every install path (#260). v0.11.6 introduces a new `iii worker add` sandbox model that agentmemory still pre-dates; pin lifts when we refactor agentmemory to register as a sandboxed worker. Override with AGENTMEMORY_III_VERSION=<version> for users who've migrated manually. - README documents iii worker add extension surface (#242). - README iii Console install/launch commands corrected (#243). Validated: 852/852 tests pass, npm run build clean.

@Nizar-BenHamida

Bug-fix patch focused on search recall correctness and plugin compatibility. Pins iii-engine to v0.11.2 because v0.11.6 introduces a new sandbox-everything-via-`iii worker add` model that agentmemory hasn't been refactored for yet — pin lifts once that refactor lands. Adds a hard guard against silent vector-index corruption, fixes BM25 indexing for memories saved via memory_save, and lands four Hermes plugin fixes. Per AGENTS.md release checklist: - package.json version 0.9.4 -> 0.9.5 - src/version.ts VERSION constant - src/types.ts ExportData version union - src/functions/export-import.ts supportedVersions Set - test/export-import.test.ts assertion - plugin/.claude-plugin/plugin.json version - CHANGELOG.md detailed entries with contributor shoutouts Headlines (full detail in CHANGELOG): Fixed: - BM25 search now indexes memories saved via memory_save (#258, #257) Thanks @Nizar-BenHamida for the precise repro. - Embedding providers no longer silently corrupt the vector index when an API returns wrong-dimension vectors (#248, #247, #256) Thanks @AmmarSaleh50 for issue + fix + tests. - Hermes handle_tool_call returns JSON strings, not raw dicts (#255, #254) Thanks @KyoMio for the Anthropic-protocol repro. - Hermes status reflects real service state on systemd installs (#253, #250) Thanks @OptionalCoin for tracing it to env-source divergence. - Hermes hooks accept passthrough kwargs (#252, #249) Thanks @OptionalCoin again for the log analysis. - agentmemory demo now seeds observations correctly (#251, #229) Thanks @seishonagon for root-cause analysis. - LLM compression / summarization timeouts increased (#213) Thanks @xuli500177. - Pi / OpenClaw / Hermes integration plugin fixes (#230) Thanks @deepmroot. Changed: - iii-engine pinned to v0.11.2 across every install path (#260). v0.11.6 introduces a new `iii worker add` sandbox model that agentmemory still pre-dates; pin lifts when we refactor agentmemory to register as a sandboxed worker. Override with AGENTMEMORY_III_VERSION=<version> for users who've migrated manually. - README documents iii worker add extension surface (#242). - README iii Console install/launch commands corrected (#243). Validated: 852/852 tests pass, npm run build clean.

vercel Bot deployed to Preview May 8, 2026 16:50 View deployment

rohitg00 merged commit 4ef188e into main May 8, 2026
5 checks passed

rohitg00 deleted the docs/fix-iii-console-commands branch May 8, 2026 16:52

This was referenced May 8, 2026

feat: hierarchical outline index for long markdown artifacts #241

Open

chore(release): v0.9.5 — search recall + plugin compatibility #261

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs(readme): correct iii console install + launch commands#243

docs(readme): correct iii console install + launch commands#243
rohitg00 merged 1 commit intomainfrom
docs/fix-iii-console-commands

rohitg00 commented May 8, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

vercel Bot commented May 8, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented May 8, 2026 •

edited

Loading

Walkthrough

Changes

Estimated code review effort

Possibly related PRs

Poem

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

rohitg00 commented May 8, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

Verified against

Test plan

Summary by CodeRabbit

Documentation

Uh oh!

vercel Bot commented May 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented May 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Estimated code review effort

Possibly related PRs

Poem

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

rohitg00 commented May 8, 2026 •

edited by coderabbitai Bot

Loading

vercel Bot commented May 8, 2026 •

edited

Loading

coderabbitai Bot commented May 8, 2026 •

edited

Loading