Aliases

Aliases are saved, named commands you run from the Aliases menu — handy for the multi-step routines you’d otherwise retype every session.

How aliases are organized

You manage everything through the Aliases menu UI — there is no text config to hand-edit.

Groups — aliases live in named groups (a group is just a labeled collection).
Alias — has a name and one or more commands (shell command lines, one per line).
Namespaces — each alias is either Global (available everywhere) or Project (stored in the open project’s .gridmux/aliases.json, and only shown when a project folder is open). In the menu, a G or L pill marks each alias’s namespace.

Open the menu from the Aliases button in the menu bar, or with Ctrl+Shift+A.

Under the search box, a Global / Project tab bar selects which namespace the list shows — Global is the default, and Project is only available while a project folder is open. Favorites appear above the list and always include both namespaces, whichever tab is active. The Project list and Favorites update automatically when you switch projects.

Create a group

In the Aliases menu, select the Global or Project tab to choose where the group lives, then click + Group in the footer and type a name. The new group is created in the active tab’s namespace. (The Project tab — and therefore project-local groups — is only available when a project folder is open; otherwise new groups are Global.)

Create an alias

Right-click a group and choose New Alias. Enter a name, then type the commands — one command per line — and click Create.

Run an alias

Click the alias in the menu. Its commands are sent to the active terminal (if no terminal is active, Gridmux prompts you to open one first). Star an alias (☆ / ★) to pin it to a Favorites section at the top of the menu.

Variables

Commands can contain variables written as $name (a $ followed by a letter or underscore, then letters/digits/underscores). When you run an alias that contains variables, Gridmux opens a dialog asking for each value before the commands run.

Edit, rename, delete

Right-click an alias for Edit Commands, Rename, or Delete. Right-clicking a group gives Rename, New Alias, and Delete.

Import and export

The menu footer has:

Export — save your aliases to a file.
Import — replace your global aliases from a file.
Import from project — scan the open project (for example, package.json scripts) and create aliases from what it finds.

Example

Say you start every project the same way. In the Aliases menu:

Click + Group and name it Dev.
Right-click Dev → New Alias, name it start, and enter, one per line:
- npm install
- npm run dev
Click Create.

Now clicking start in the Aliases menu runs both commands in the active terminal. To make one reusable across repos, create an alias clone with the command git clone $repo — running it asks for repo, then runs the command with the value you enter.