opencode-lens-mcp
v0.1.4
Published
MCP server for discovering and controlling live opencode-lens TUI plugin instances.
Maintainers
Readme
opencode-lens-mcp
MCP server for opencode-lens. It discovers running opencode TUI instances that have the opencode-lens plugin loaded and exposes tools for local agents such as Hermes.
Install
npm install -g opencode-lens-mcp --registry=https://registry.npmjs.org/Use the official npm registry for fresh releases. Regional mirrors can lag behind and make npx report that the package is not found.
Hermes Configuration
mcp_servers:
opencode-lens:
command: npx
args:
- -y
- --registry=https://registry.npmjs.org/
- opencode-lens-mcp
enabled: true
timeout: 30
connect_timeout: 10Restart Hermes after installing or updating the MCP server so the tool list is reloaded.
Tools
instances_listsessions_listtui_statussession_createprompt_sendmessages_readdiff_gettodo_gettui_session_switchquestion_respondquestion_rejectpermission_respondmodel_selector_close
Notes
- This package talks to local Unix sockets created by the
opencode-lensTUI plugin. - It does not start opencode and does not open network listeners.
instances_listintentionally returns only compact instance metadata. Usesessions_listwith alimitwhen session history is needed.- The distributed
dist/opencode-lens-mcp.jsbundle is self-contained except for Bun/Node built-ins.
License
MIT
