Skip to content

Repository files navigation

Command Palette

Command Palette is a Cmd/Ctrl+K quick launcher for Agent Zero. It keeps chats, projects, and commands within keyboard reach, with editable hotkeys for opening the palette and moving through its results.

Features

  • Four built-in actions: New Chat, Open Projects, Save Chat, and Restart Backend.
  • Search and open top-level chats, with their assigned project color.
  • Search and open projects, with Agent Zero's saved project color.
  • Discover context-effective dynamic slash commands supplied by Agent Zero's current command resolver.
  • Edit the bindings used to open, navigate, confirm, and close the palette.

Installation

Plugin Hub

Plugin Hub installation will be available only after the command_palette marketplace listing is merged. Until then, use manual installation.

After the listing is merged:

  1. Open Agent Zero's Plugin Hub.
  2. Find Command Palette and install it.
  3. Restart Agent Zero if the Plugin Hub prompts you to do so.

Manual installation

Once https://github.com/TerminallyLazy/command-palette-agent-zero has been published, clone it from the Agent Zero repository root into usr/plugins/command_palette:

git clone https://github.com/TerminallyLazy/command-palette-agent-zero.git \
  usr/plugins/command_palette

Restart Agent Zero so it discovers the new plugin.

Enable and configure

  1. Enable Command Palette for the desired scope in the installed Plugins view.
  2. To Configure its hotkeys, open Settings → Agent Settings → Plugins → Command Palette → Config, edit the bindings, and save.

Saved bindings take effect without reloading Agent Zero. Use the shared settings Reset control to restore the defaults.

The defaults are:

Action Binding
Open palette mod+k
Next item arrowdown
Previous item arrowup
Confirm item enter
Close palette escape

Binding syntax

mod maps to Cmd on macOS and Ctrl elsewhere. The explicit modifiers are ctrl, meta, alt, and shift. Join modifiers and the key with +, for example mod+k or ctrl+shift+p.

Each binding accepts modifiers plus one non-modifier key. Key names are case-insensitive, so MOD+K and mod+k are equivalent.

Usage

  1. Press mod+k (or your configured open binding).
  2. Type to filter built-in actions, top-level chats, projects, and available slash commands.
  3. Use arrowdown and arrowup to move through results.
  4. Press enter to run the selected result, or escape to close the palette.

You can also open the palette with its icon in the sidebar quick actions.

Restart Backend asks for confirmation before requesting a restart. Cancel the confirmation to return without restarting Agent Zero.

Privacy and security

Command Palette makes no third-party network requests. It does not collect or store secrets. Navigation and command execution delegate to the existing Agent Zero stores and command resolver, so the plugin does not introduce a parallel authentication or execution path.

Compatibility

Version 1.0.0 targets Agent Zero upstream/ready at exact baseline 84da8420d269df1d0f5e771e13c7e86ebdad1e57.

Verification

The release gate covers the exact manifest and default-configuration contracts, hotkey parsing and dispatch, search and navigation behavior, dynamic command resolution, restart confirmation, lifecycle cleanup, and compatibility with the baseline above.

License

Command Palette is available under the MIT License.

About

Cmd/Ctrl+K command palette for Agent Zero chats, projects, actions, and slash commands.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages