How do I add a new tab to my iTerm2 layout?

Simply add a [[tabs]] entry to your ~/.config/iterm2/layout.toml file with the directory path and an optional name, then restart iTerm2.

Does this skill support Git worktrees?

Yes, it includes optional worktree detection that can automatically scan a root directory and generate tabs for all active Git worktrees.

Where are the configuration files stored?

Private workspace paths are stored in ~/.config/iterm2/layout.toml following XDG standards, while the public logic resides in your scripts directory.

What happens if a directory in my config doesn't exist?

The script employs a 'print + early return' pattern, logging a warning to the iTerm2 Script Console and skipping that specific tab while continuing to load the rest of your layout.

Can I customize the layout ratio of terminal panes?

Yes, the [layout] section in the TOML configuration allows you to define the left_pane_ratio and settle_time for automated command execution.

iTerm2 Workspace Layout Manager

Name: iTerm2 Workspace Layout Manager
Author: terrylica

byterrylica

•

Productivity & Workflow

Automates the configuration and management of iTerm2 workspace layouts using a centralized TOML-based configuration system.

iTerm2 Workspace Layout Manager streamlines your terminal environment by automating the setup of tabs and panes across different projects. By separating private workspace paths into a TOML configuration and keeping logic in a reusable Python script, it enables clean, reproducible development environments. This skill is particularly useful for developers managing multiple projects or complex git worktrees, allowing for automatic tab creation, pane splitting, and custom command execution upon iTerm2 launch without exposing sensitive local paths in shared scripts.

Key Features

01TOML-based layout configuration for easy maintenance

02Dynamic Git worktree detection and automatic tab generation

032 GitHub stars

04Customizable pane ratios and startup command execution

05Clean separation of private configuration and shared logic scripts

06Automated tab creation for specific project directories

Use Cases

01Automatically opening all relevant project tabs and splitting panes on startup

02Standardizing terminal environments across multiple development machines

03Managing complex Git worktree environments with dynamic terminal tab labeling

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add terrylica/cc-skills iterm2-layout

For use in Claude.ai and ChatGPT

Download Skill