Custom commands

Not every command lives in a script file. Buttons lets you add any command — docker ps, git pull, curl … — directly as a button.

Adding a custom command

1. Click + Add command in the Project or Global section.
2. Type the command (for example docker ps) and an optional note.
3. Click Save.

Custom commands are stored verbatim and are never rewritten by scanning.

Project vs global

Where you add the command decides its scope:

• Project — stored in <workspace root>/.buttons.json, available only in the current workspace.
• Global — stored in ~/.buttons.json, available in every project you open.

Use project commands for workspace-specific tooling and global commands for the things you run everywhere.

Tip

Commands that aren’t auto-parsed from a script file — Python pyproject.toml tasks, Rust cargo invocations, Docker commands — are a good fit for custom commands.