How to Rename Terminal Windows and Tabs on macOS
If you've ever stared at a row of terminal tabs all named "zsh" or "bash" trying to remember which one is running your dev server, you're not alone. This is one of the most common frustrations for developers on macOS.
This guide covers how to rename terminal windows and tabs so you can actually find what you're looking for.
The Problem with Default Terminal Names
By default, most terminal apps on macOS name tabs after the running shell (zsh, bash) or the current directory. When you have 10+ terminals open, they all look the same:
- zsh
- zsh
- zsh
- ~/projects/frontend
- ~/projects/backend
- zsh
Good luck finding your API server in that mess.
Option 1: Terminal.app (Built-in macOS Terminal)
The default macOS Terminal has limited renaming options:
- Click Shell → Edit Title in the menu bar
- Or use the escape sequence:
echo -ne "\033]0;Your Title\007"
The problem? The title often gets overwritten when you run commands or change directories. It's not persistent.
Option 2: iTerm2
iTerm2 handles this better:
- Double-click the tab to rename it
- Or right-click → Edit Session Name
- Or use ⌘⇧I to edit
iTerm2 names are persistent within a session, but you'll need to rename everything again when you restart.
Option 3: Beam (Recommended)
Beam was built with naming as a first-class feature. Here's how it works:
Rename Tabs
- Double-click any tab to rename it
- Or press ⌘⇧I to rename the current tab
Rename Workspaces
- Double-click the workspace name
- Or press ⌘⌥I to rename
Rename Split Panes
- Double-click the pane label
- Or press ⌘⌥⌃I to rename the current pane
The Best Part: Names Persist in Layouts
When you save a layout in Beam, all your names are saved too. Restore a layout and everything comes back exactly as you named it. No more re-naming terminals every time you start work.
Keyboard Shortcuts Summary
| Action | Shortcut |
|---|---|
| Rename current tab | ⌘⇧I |
| Rename current workspace | ⌘⌥I |
| Rename current split pane | ⌘⌥⌃I |
| Save layout (with names) | ⌘S |
Naming Best Practices
Here are some tips for naming terminals effectively:
Use Descriptive Names
- ❌ "zsh"
- ✓ "Frontend Dev Server"
- ✓ "API Logs"
- ✓ "Claude Code - Backend"
Use Consistent Prefixes
If you have multiple related terminals, use prefixes:
- "FE: Dev Server"
- "FE: Tests"
- "BE: API"
- "BE: Workers"
Include the Action
What is this terminal doing?
- "Running: Vite Dev"
- "Watching: Jest Tests"
- "SSH: Production Server"
Why This Matters
Good terminal naming isn't just about aesthetics. It's about:
- Speed – Find the right terminal instantly instead of clicking through tabs
- Safety – Never accidentally run a production command in the wrong terminal
- Focus – Less cognitive overhead means more brain power for actual coding
- Collaboration – If you share your screen, others can follow along
Stop Hunting Through "zsh" Tabs
Download Beam and give your terminals the names they deserve.
Download Beam for macOSSummary
Renaming terminal windows on macOS is possible in most apps, but Beam makes it easiest with:
- Double-click to rename anything
- Keyboard shortcuts for power users
- Names that persist across sessions via layouts
- Three levels of naming: workspaces, tabs, and split panes
Your future self (trying to find that one terminal at 2am) will thank you.