agentic-workbench/agent-quick-menu
agent-quick-menu: Claude Code 통합 빠른 메뉴
Claude Code에 통합 빠른 메뉴를 제공합니다: 세션 패널과 프롬프트 바에 각 플러그인의 명령, 설정 및 Claude Code 자체의 /config 설정을 표시합니다. 접기, 즐겨찾기, 필터링 및 즉석 수정이 가능합니다.
이 mod 소개
agent-quick-menu는 Claude Code 세션에 통합 메뉴 패널(/menu로 열기)과 프롬프트 바 위의 바로가기 바를 추가합니다. .claude-plugin/quick-menu.json을 제공하는 각 플러그인에는 접을 수 있는 섹션이 제공되며, 해당 명령은 버튼으로, 설정은 레이블/값 테이블로 표시됩니다. Claude Code 자체의 /config 설정도 별도 섹션에 나열됩니다. 명령 버튼은 실제로 실행될 슬래시 명령을 표시하며, 내장 또는 다른 플러그인 명령은 5초 이내에 재확인이 필요하고 메뉴 파일은 신뢰할 수 없는 입력으로 처리됩니다. 설정 행은 직접 편집할 수 있습니다: 부울은 토글, 옵션은 버튼 행, 텍스트와 숫자는 입력 상자를 열고 저장/취소를 지원합니다. 모든 행을 ☆로 즐겨찾기할 수 있으며, 즐겨찾기는 패널 상단에 고정되고 프롬프트 바 바로가기 바에 나타나며 키보드 단축키로 트리거할 수 있습니다. 상단 필터 상자는 이름과 설명으로 섹션을 가로질러 검색합니다. 섹션은 모두 펼치기/접기가 가능하며 세션 간에 유지됩니다. 구분: 전역 단축키 없음, VS Code 채팅 패널 미지원, Windows 미테스트; 버튼을 누를 때만 해당 명령을 실행하며 데이터를 업로드하지 않고 자격 증명을 읽지 않습니다.
설치
먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.
/plugin marketplace add agentic-workbench/agent-quick-menu /plugin install agent-quick-menu@agent-quick-menu /reload-plugins
원문 / 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.
배지 받기
내 프로젝트인가요? 이 배지를 README나 웹사이트에 넣으면 이 페이지로 연결됩니다.


