A simple and flexible Wox 2 plugin that allows you to define custom shell commands, scripts, or actions via a JSON file. Trigger commands with aliases or keywords directly from Wox!
- Map custom shell commands to Wox keywords
- Support for CMD, PowerShell, and custom executables
- Lightweight and easy to configure
- Supports parameterized inputs
-
Go to the Wox plugin directory:
- macOS:
~/.wox/wox-user/plugins/ - Windows/Linux: 'Your Wox installation directory/plugins/'
- macOS:
-
Go to release page and download the latest version of the plugin
-
Extract the contents of the ZIP file into a new folder named
CustomCommandin the Wox plugin directory. -
Restart Wox.
- Open the
Custom Command Settingsin Wox (Plugins/Installed Plugins/Custom Command/Settings) - Edit the field (it's a JSON text field)
- Press Enter to save the changes (no need to restart Wox)
- You'll see if it works directly in Wox, just type the shortcut name and if it appears, it works!
[
{
"shortcut": "Gitlab",
"script": "open 'https://gitlab.com/search?scope=merge_requests&search=$@'",
"description": "Search merge requests in Gitlab $@"
},
{
"shortcut": "Random",
"script": "say $((RANDOM % $1))",
"description": "Generate a random number between 0 and $1"
}
]You can use $@ to pass all arguments and $1, $2, etc. to pass specific arguments. The script can be a shell command, PowerShell command, or a path to an executable.