KB / Memory / tech-herdr-no-plugin-context-menu
Herdr cannot put plugin items in the sidebar right-click menu
Herdr 0.9.3 builds the workspace context menu from hardcoded variants; contexts=["workspace"] is parsed and never acted on
Verified against stable 0.9.3 source. A plugin cannot add an item to the workspace / tab / pane right-click menu, and no manifest field is waiting to be filled in:
src/client/shell/context_menu.rsbuilds the menu as amatchover the target kind returning hardcodedClientContextMenuActionvariants. There is no plugin branch.PluginActionContext— the enum behindcontexts = ["workspace"]— is deserialized by the manifest loader, stored inPluginActionInfo, and has no consumer anywhere insrc/. Declaring it is honest intent that Herdr parses and never acts on.- The manifest accepts only
build,startup,actions,events,panesandlink_handlersentries. No menu or grouping key exists, and the plugins doc states native non-terminal plugin UI and runtime action registration are not part of plugin v1.
What a plugin can do for a workspace: an action with
contexts = ["workspace"] (listed under plugin actions, invoked by keybinding
or herdr plugin action invoke), a panes popup, and workspace display
tokens via herdr workspace report-metadata --source <plugin> --token k=v,
which Herdr renders beside the Space label. The invocation context arrives in
HERDR_PLUGIN_CONTEXT_JSON with HERDR_WORKSPACE_ID as fallback.
Why: "add this to the right-click menu" is not implementable, and time spent looking for the manifest key is wasted. How to apply: ship the workspace-scoped action plus a popup, and say plainly in the docs that it is not in the right-click menu.