iterm2-layout

Configure iTerm2 workspace layouts using a TOML config file.

62|10|Updated Dec 4, 2025
One-click install
npx skills add https://github.com/terrylica/cc-skills --skill iterm2-layout
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iterm2-layout
Source: https://github.com/terrylica/cc-skills/tree/main/plugins/iterm2-layout-config/skills/iterm2-layout
Command: npx skills add https://github.com/terrylica/cc-skills --skill iterm2-layout

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Configure and manage iTerm2 workspace layouts across machines with a TOML config, separating private config from public scripts and templates.

Core Features & Use Cases

  • Private config: ~/.config/iterm2/layout.toml
  • Public script: ~/scripts/iterm2/default-layout.py
  • Template: ~/scripts/iterm2/layout.example.toml
  • Tabs: multiple [[tabs]] with dir and optional names

Quick Start

Copy template, edit with your workspace paths, and restart iTerm2 to test layout changes.