Skip to content

README Tools section outdated: 8 tools undocumented, count wrong, roadmap lists already-shipped features #32

Description

@vincentvella

Problem

README.md has three related stale spots:

1. Wrong tool count — The "Tools (37)" heading is incorrect; src/toolSpecs.ts currently defines 45 tools (45 defineTool() calls).

2. 8 tools absent from the Tools section — The following tools exist in toolSpecs.ts and are fully implemented in src/toolLayer.ts but are not listed anywhere in the README's Tools section:

  • browser_back, browser_forward, browser_reload
  • pane_set_label
  • ext_list, ext_install, ext_remove, ext_set_enabled

3. "Where to take it next" lists shipped work as TODO — The bullet reads:

"Full MCP parity — the last cockpit-only affordances as tools: extension management (ext_*) + browser_back/forward/reload + pane_set_label."

All of these are already implemented and handled in src/toolLayer.ts. The bullet should be removed; the items should join the Done list at the bottom.

Impact

Agents and developers reading the README to discover available tools will miss 8 of the 45 tools. The roadmap section actively misleads them into thinking these tools don't exist yet.

Proposed Fix

  • Update "Tools (37)" → "Tools (45)".
  • Extend the browser-control list with browser_back, browser_forward, browser_reload.
  • Add pane_set_label to the Panes section.
  • Add an Extensions subsection documenting ext_list, ext_install, ext_remove, ext_set_enabled (cockpit-only, mirroring the native tools pattern).
  • Remove the "Full MCP parity" bullet from "Where to take it next"; add its items to the Done list.

Affected Files

  • README.md (Tools section, "Where to take it next" bullet, Done list)

Metadata

Metadata

Assignees

Labels

docsDocumentation

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions