Loopty Docs

Using Loopty

Terminal Commands

Run shell commands directly from the radial menu.

Terminal command shortcuts let you run shell commands directly from the radial menu. They appear alongside your app and folder shortcuts and open in whichever terminal emulator you prefer.

Creating a terminal command

  1. 1Open Settings and go to the Commands tab.
  2. 2Click New Command.
  3. 3Enter a display name and the shell command you want to run (e.g. npm run dev, git pull, or any multi-part command).
  4. 4Choose which terminal app to open it in. Only apps installed on your Mac are listed.
  5. 5Optionally upload a custom icon — otherwise the terminal app's icon is used.
  6. 6Click Add Command to save it to your command library.

Adding a command to your menu

Saved commands appear as tiles in the Commands tab. Drag a tile onto the radial menu preview to place it on a ring, then save. The command is now a regular menu item.

Supported terminal apps

Loopty can open commands in any of the following terminals:

AppNotes
TerminalBuilt-in macOS terminal. Used via AppleScript.
iTerm2Used via AppleScript.
WarpOpens via a temporary shell script file.
GhosttyOpens via a temporary shell script file.
AlacrittyOpens via a temporary shell script file.
HyperOpens via a temporary shell script file.
kittyOpens via a temporary shell script file.

How commands run

For Terminal and iTerm2, Loopty uses AppleScript to send the command directly into a new window or tab. For all other apps, Loopty writes a temporary shell script and opens it, which sources your shell profile so aliases and functions defined in ~/.zshrc are available. The terminal window stays open after the command finishes.

Note: If macOS prompts you to allow Loopty to control Terminal or iTerm2, click OK. This Automation permission is required for AppleScript-based execution. If you deny it, Loopty will fall back to the shell script method automatically.

Custom icons

Each command can have a custom icon (PNG, JPEG, HEIC, or TIFF). The icon is resized to 128×128 px and stored with the command. You can also adjust the icon scale globally in the Commands tab to make terminal command icons larger or smaller relative to other items on the menu.