agentic-workbench/agent-quick-menu
agent-quick-menu: Unified Quick Menu for Claude Code
Provides a unified quick menu for Claude Code: displays commands and settings from various plugins, as well as Claude Code's own /config settings, in the session panel and prompt bar. It is collapsible, favorite-able, filterable, and editable in place.
About this mod
agent-quick-menu adds a unified menu panel (/menu to open) and a shortcut bar above the prompt bar in Claude Code sessions. Each plugin that provides a .claude-plugin/quick-menu.json gets a collapsible section, with its commands shown as buttons and settings presented as a label/value table; Claude Code's own /config settings are also listed in a separate section. Command buttons display the actual slash command that will be executed; built-in or other plugin commands require a second confirmation within 5 seconds, and menu files are treated as untrusted input. Setting rows can be edited directly: booleans as toggles, options as button rows, text and numbers open input boxes with save/cancel support. Any row can be favorited with ☆; favorites are pinned at the top of the panel and appear in the prompt bar shortcut bar, triggerable via keyboard shortcuts. The top filter box searches across sections by name and description; sections can be expanded/collapsed all at once and persist across sessions. Distinctions: no global hotkey, VS Code chat panel is not supported, Windows is untested; it only executes the corresponding command when you press the button, does not upload data, and does not read credentials.
Installation
Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.
/plugin marketplace add agentic-workbench/agent-quick-menu /plugin install agent-quick-menu@agent-quick-menu /reload-plugins
Original text / README
Highlights
- Every plugin in one place. Each plugin gets a foldable section with its commands as buttons and its settings as editable rows; Claude Code's own
/configsettings get one too. - Commands that ask. A button can prompt for its argument (a branch, a date) before it runs, with save and cancel.
- Settings you can change in place. Toggles, option buttons and text fields, each with its description; a filter finds a row by name or description.
- Favourites in the band. Pin any command or setting with ☆ and it sits above the prompt, one press away.
- Safe by default. Every button shows the slash command it runs; another plugin's or a built-in command needs a second press. Menu files are treated as untrusted input.
- One file to join. A plugin registers with a small
.claude-plugin/quick-menu.json; no code, no dependency.
Requirements
Claude Code 2.1.287 or newer, in the terminal or the Desktop Code tab, on macOS or Linux. The VS Code chat panel is not supported. Windows paths (USERPROFILE, ; in CLAUDE_CODE_PLUGIN_DIRS) are read, but the menu is untested there.
Install
In a Claude Code session:
/plugin marketplace add agentic-workbench/agent-quick-menu
/plugin install agent-quick-menu@agent-quick-menu
/reload-plugins
Or from a shell:
claude plugin marketplace add agentic-workbench/agent-quick-menu
claude plugin install agent-quick-menu@agent-quick-menu
Then run /reload-plugins in a running session.
Usage
/menuopens the pane./menu refreshdiscovers plugin menus again.- The band above the prompt is one line:
≣ menu ▸ │ Pull Status …(hotkeymwhile the band is focused, then your favourites). The button toggles: it closes the menu when it is open (▾) and opens it when closed (▸);/menualways opens or focuses it. WithbandHotkeyson, own-plugin commands read1 Pull 3 Status, the digit being the place in the pinned list. ctrl+x tabfocuses the band.- Band digits are opt-in: with the
bandHotkeyssetting on (default off) and an empty prompt,1to9press the pinned commands of this plugin only, numbered by their position in the pinned list (a gap keeps the other numbers). Other plugins' commands and setting favourites carry no digit. Digits do not arm while the band scrolls, and another mod's same hotkey may win. ☆/★on any row adds or removes a favourite. Favourites are listed first in the pane.- Every section folds: press its header (
▸/▾). Favourites start open, every other section folded.Expand all(e) andCollapse all(c) sit on the top line; the state is kept across sessions. The pane closes with Claude Code's own×, Escape or ctrl+x x. With no favourites yet, the pane says to press☆on a row. - The filter field at the top (
filter…) matches setting labels, keys and descriptions and command names and labels, case-insensitive, across every section. Sections without a match are hidden, matching ones open while a filter is set, and the counts follow. - Every setting row is a plain label and a value, and a press edits it: a boolean is a green
●(on) or gray○(off) with the plain wordon/off; a choice opens an inline row of option buttons (● current,○ other), one editor open at a time; text and number rows showvalue ✎and open an Input with✓ saveand✕ cancel. Cancel is the button: Escape does not cancel the edit (it closes the pane). Commands and settings show a dim italic description after·. - A command with
askin its menu entry opens that same editor when pressed, in the pane or from a band favourite (which opens the pane at its row), with the default typed in and✓ run/✕ cancel. Enter or✓ runruns/command <args> <input>; the row hint reads/command <args> …. The confirm-twice of a built-in or another plugin's command applies to✓ run. See docs/convention.md. - If the terminal is too narrow to place the pane, a toast says so and the band lists the sections (header buttons, at most as many rows as the band may take, and a
Closebutton, since the engine draws no close mark there) instead. [-]at the end of the band (drawn by Claude Code, or ctrl+x ctrl+a) folds the band.
What appears
- One section per plugin that ships a
.claude-plugin/quick-menu.json: its commands one per line (button, then the/command argshint) and its settings (userConfig) as an aligned label/value table. A setting's description (userConfigdescription) follows its value dimmed, clipped to the pane width and dropped when under 8 cells remain; the filter matches it too. - A commands-only section for a plugin loaded with
--plugin-dirwhose root is not known (see Limitations): its registered commands, and a dim line saying to setCLAUDE_CODE_PLUGIN_DIRS. - A settings-only section for each plugin without the file that has
userConfigrows. - A "Claude Code" section with Claude Code's own settings.
- A locked row (
managed) is set by managed policy and cannot be changed here. - A "Problems" list shows plugin files that were skipped and why.
What this plugin does on your machine
Slash commands it runs, and when. Only when you press a button or a band favourite, and only the command that row shows: /<command> <args> from a plugin's quick-menu.json. Built-in commands and other plugins' commands need a second press within 5 seconds. When you change a setting row it runs /config <key>=<value>, then reads the row back through $.config.list() to judge whether the write took. It runs nothing on its own.
What it sets. Only the /config rows you change in the pane. It sets no environment variables. It keeps favourites and folded sections in Claude Code's plugin store.
What it reads. Your settings (enabledPlugins), the plugin registry installed_plugins.json under CLAUDE_CONFIG_DIR or ~/.claude, the environment variables CLAUDE_CONFIG_DIR, HOME, USERPROFILE and CLAUDE_CODE_PLUGIN_DIRS, each plugin's .claude-plugin/quick-menu.json, the .claude-plugin/plugin.json of the folders in CLAUDE_CODE_PLUGIN_DIRS, the list of commands Claude Code offers, and the rows /config shows. It sends nothing over the network and reads no credentials.
Its hooks.
ui.renderonAbovePrompt: adds its own row and keeps every other mod's band beneath it.ui.renderon itsPane: draws the menu.command.run, matched to/menuonly: answers/menuand/menu refreshitself. It never sees, changes or blocks any other command, including the ones it runs for you.plugin.register: reads the name, root and provenance of each plugin as it loads, to find thequick-menu.jsonof plugins loaded with--plugin-dir. It passes every registration on unchanged and never alters or blocks a plugin, its settings, instructions, hooks or tool descriptions.ui.close: observed only, to redraw the band's menu button when the pane closes. It passes every close on unchanged.session.start: registers/menu, loads favourites and folds, and starts discovery.
For plugin authors
Add .claude-plugin/quick-menu.json to your plugin:
{
"$schema": "https://raw.githubusercontent.com/agentic-workbench/agent-quick-menu/main/schema/quick-menu.schema.json",
"version": 1,
"commands": [
{ "command": "my-plugin:status", "label": "Status", "description": "Show the plugin's state" },
{ "command": "my-plugin:deploy", "label": "Deploy to…", "ask": { "placeholder": "environment", "default": "staging" } }
],
"settings": ["verbose"]
}
That's it: commands become buttons, ask prompts for an argument first, and settings lists which of your userConfig fields to show (omit it to show all). Without agent-quick-menu installed the file is never read. The full format, limits and versioning promise are in docs/convention.md.
Limitations
- There is no global hotkey; the band hotkeys work only while the band is focused or the prompt is empty.
- A
--plugin-dirplugin's root is only learned when its hooks module loads after this one (plugin.register; kept across a reload of the menu); a plugin without one, or loaded earlier, is listed from$.command.list()with its commands only. SetCLAUDE_CODE_PLUGIN_DIRSto the same folder to read itsquick-menu.json. A--plugin-dircopy shadows an installed copy of the same plugin. The menu reads its own file from its own folder. - Discovery runs in the background, after every plugin's
session.startand on/menu refresh(which toasts the counts when it is done), so/menuanswers at once. - Settings that are not shown in
/configare not shown here. - A favourite setting that is not boolean opens the pane instead of toggling.
Releases
Releases follow semantic versioning: version in plugin.json is the release, tagged as v<version> and listed in CHANGELOG.md. Claude Code updates an install when that version changes, so installs from main get each release.
Development
make check # JSON check, claude plugin validate + test, and tsc --noEmit (tsc from PATH, else via npx)
claude --plugin-dir . # try the plugin from this checkout
Contributing
See CONTRIBUTING.md for branches, commits and tests, and the Code of Conduct.
Privacy
See PRIVACY.md: the plugin collects and sends nothing.
Security
Report vulnerabilities privately, see SECURITY.md.
License
MIT, see LICENSE.
Get a badge
Is this your project? Add this badge to your README or website. It links back to this page.


