

If this helped you improve your iTerm2 workflow, consider following me on Twitter.The macOS shortcuts seem like an easy thing to dismiss. The creator Nachman is responsive on Twitter for iTerm2 questions. If this is the case, after you've saved your arrangement with ⌘ Shift S, you must restart iTerm2. You can only test it by re-opening a new arrangement with the keyboard shortcut you set up.Īfter saving an arrangement, it might not show up in the menu item dropdown when creating a new keyboard shortcut. After modifying your shell commands, repeat the "Edit Session" steps including hitting "Change Profile." Then save your arrangement again and overwrite the old one with the same name. The profile doesn't live update, it somehow caches an old version of your shell commands. If your startup commands don't work as expected then you have to modify your session profile commands, then you have to re-assign the profile to the shell. Hopefully everything worked fine and you have a shortcut you can trigger to set up a custom arrangement! Troubleshooting
ITERM KEYBOARD SHORTCUTS WINDOWS

I've found that sometimes iTerm will run the "send text at start" before it opens that directory though. You can also use the "directory" radio button, and not use the cd A do B syntax. It's better to use between commands instead of & so that if any command fails, the rest still get executed. For example you might type cd ~/my-work-folder npm run watch, which is what's executed in this shell. Under "Send text at start" type the commands, including cd to the correct starting directory, for this shell to execute on startup. Open preferences with ⌘-, (Command-Comma)Ĭreate a new profile and name it something specific to this arrangement and shell, like "Work Build Process" This is complicated and has several steps. ⌘-D and ⌘-Shift–D are useful shortcuts for creating vertical and horizontal splits. Just set up the layout of splits and tabs. Open a new window and set up your tab and split layout as desired.ĭon't run any processes, nor cd into any directories yet. Any windows open in the background will also be saved. We'll use the "Save Window Arrangement" feature which saves all windows.
ITERM KEYBOARD SHORTCUTS HOW TO
How to Create a Custom Window Arrangement I've attempted to document known pitfalls. ITerm2 is useful software, but this process is complicated. Screenshot of the "Restore Window Arrangement" iTerm2 shortcut

All posts tech nutrition growth How to Create Custom iTerm2 Window Arrangementsīy following these steps, we'll learn how to create a custom keyboard shortcut to automatically spawn a set of windows and splits with processes running.
