agent-quick-menu 在 Claude Code 会话中新增一个统一菜单面板（/menu 打开）和提示栏上方的一行快捷带。每个提供 .claude-plugin/quick-menu.json 的插件都会得到一个可折叠分区，其命令显示为按钮、设置以标签/值表格呈现；Claude Code 自身的 /config 设置也单列一区。命令按钮会显示实际执行的斜杠命令，内置或其他插件命令需在 5 秒内二次确认，且菜单文件按不可信输入处理。设置行可直接编辑：布尔为开关、选项为按钮行、文本和数字打开输入框并支持保存/取消。任意行可用 ☆ 收藏，收藏项在面板中置顶并出现在提示栏快捷带中，可通过快捷键触发。顶部过滤框按名称与描述跨分区搜索；分区可全部展开/折叠并跨会话保持。区分：无 global hotkey，VS Code 聊天面板不支持，Windows 未测试；仅在你按下按钮时执行对应命令，不上传数据、不读取凭据。
请先查看作者 README 确认 marketplace 和插件名称；命令可能随仓库结构改变。
/plugin marketplace add agentic-workbench/agent-quick-menu /plugin install agent-quick-menu@agent-quick-menu /reload-plugins
/config settings get one too..claude-plugin/quick-menu.json; no code, no dependency.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.
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.
/menu opens the pane. /menu refresh discovers plugin menus again.≣ menu ▸ │ Pull Status … (hotkey m while the band is focused, then your favourites). The button toggles: it closes the menu when it is open (▾) and opens it when closed (▸); /menu always opens or focuses it. With bandHotkeys on, own-plugin commands read 1 Pull 3 Status, the digit being the place in the pinned list.ctrl+x tab focuses the band.bandHotkeys setting on (default off) and an empty prompt, 1 to 9 press 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.▸ / ▾). Favourites start open, every other section folded. Expand all (e) and Collapse 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.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.● (on) or gray ○ (off) with the plain word on / off; a choice opens an inline row of option buttons (● current, ○ other), one editor open at a time; text and number rows show value ✎ and open an Input with ✓ save and ✕ cancel. Cancel is the button: Escape does not cancel the edit (it closes the pane). Commands and settings show a dim italic description after ·.ask in 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 ✓ run runs /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.Close button, 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..claude-plugin/quick-menu.json: its commands one per line (button, then the /command args hint) and its settings (userConfig) as an aligned label/value table. A setting's description (userConfig description) follows its value dimmed, clipped to the pane width and dropped when under 8 cells remain; the filter matches it too.--plugin-dir whose root is not known (see Limitations): its registered commands, and a dim line saying to set CLAUDE_CODE_PLUGIN_DIRS.userConfig rows.managed) is set by managed policy and cannot be changed here.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.render on AbovePrompt: adds its own row and keeps every other mod's band beneath it.ui.render on its Pane: draws the menu.command.run, matched to /menu only: answers /menu and /menu refresh itself. 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 the quick-menu.json of 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.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.
--plugin-dir plugin'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. Set CLAUDE_CODE_PLUGIN_DIRS to the same folder to read its quick-menu.json. A --plugin-dir copy shadows an installed copy of the same plugin. The menu reads its own file from its own folder.session.start and on /menu refresh (which toasts the counts when it is done), so /menu answers at once./config are not shown here.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.
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
See CONTRIBUTING.md for branches, commits and tests, and the Code of Conduct.
See PRIVACY.md: the plugin collects and sends nothing.
Report vulnerabilities privately, see SECURITY.md.
MIT, see LICENSE.
CodeCraft 是一个 Minecraft 风格的 Claude Code HUD 插件：心形代表剩余上下文、护甲代表测试/提交/推送等安全网、经验条只奖励验证过的工作，对话像游戏聊天室，并有 60 个跨会话保存的成就。
提供便于复制会话内容的输入框上方辅助条。
在会话界面展示简短词汇提示。
