Skip to content

Command Palette

See Also

Reference for Command Palette : Complete documentation on the command palette options.

Overview

The command palette bound to Ctrl  P is an interactive list whose purpose is to execute commands. The command palette is fed by entries in .sublime-commands files. Usually, commands that don't warrant creating a key binding of their own are good candidates for inclusion in a .sublime-commands files.

By default, the command palette includes many useful commands, and provides convenient access to individual settings as well as settings files.

File Format (Commands Files)

Commands files use JSON and have the .sublime-commands extension.

Here's an excerpt from Packages/Default/Default.sublime-commands:

json
[
    { "caption": "Project: Save As", "command": "save_project_as" },
    { "caption": "Project: Close", "command": "close_project" },
    { "caption": "Project: Add Folder", "command": "prompt_add_folder" },

    { "caption": "Preferences: Default File Settings", "command": "open_file", "args": {"file": "${packages}/Default/Base File.sublime-settings"} },
    { "caption": "Preferences: User File Settings", "command": "open_file", "args": {"file": "${packages}/User/Base File.sublime-settings"} },
    { "caption": "Preferences: Default Global Settings", "command": "open_file", "args": {"file": "${packages}/Default/Global.sublime-settings"} },
    { "caption": "Preferences: User Global Settings", "command": "open_file", "args": {"file": "${packages}/User/Global.sublime-settings"} },
    { "caption": "Preferences: Browse Packages", "command": "open_dir", "args": {"dir": "$packages"} }
]

caption : Text for display in the command palette.

command : Command to be executed.

args : Arguments to pass to command.

How to Use the Command Palette

  1. Press Ctrl  P
  2. Select command

The command palette filters entries by context. This means that whenever you open it, you won't always see all the commands defined in every .sublime-commands file.