Global commands

Global commands form one app-wide library. They appear alongside a terminal's own commands and execute in whichever terminal is active.

Manage the library #

Open Settings with Cmd+, or the sidebar gear, then choose Commands. Add a command such as pwd, give it a friendly name through Advanced, and arrange rows by dragging. The row menu also duplicates or removes a command.

Advanced exposes a friendly name, multiline script, and Print compact command label. The current global editor has no directory or environment controls. Existing environment overrides already present in the saved configuration are preserved and used, but cannot be edited through Settings.

The compact-label option prints the name or a short preview instead of the full script in Bash, Zsh, and Fish. It keeps command output and interactive input visible and does not remove the saved script or command history. Existing environment overrides follow the same literal value and reference rules as profile commands.

Valid edits autosave; text changes save after a short delay or on leaving the field. Advanced Save and valid list changes save immediately. A blank or invalid command row remains a local draft and can prevent Settings from closing until you fix or remove it. Open Cmd+R in a terminal to find the library under Global.

Global commands do not belong to a tag, are not exported with terminals, and cannot be chosen for startup or tag Start all. Resetting preferences preserves the command library.

Use the current directory #

A global command runs in the active terminal's live current directory, with no automatic change to its configured profile directory. Before running a project-specific command such as npm test, select the intended terminal and use pwd to check its folder.

For example, if API has moved into a tests subdirectory, a global pwd reports that subdirectory. Use Go to working dir first if you want the profile root. To bind a command to a predictable directory or configure its environment through the UI, use an attached terminal command.