iterm2

iTerm2 macOS terminal emulator. Use for terminal work.

7 stars

byG1Joshi

View on GitHub Installation ↓

Best use case

iterm2 is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

iTerm2 macOS terminal emulator. Use for terminal work.

Teams using iterm2 should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/iterm2/SKILL.md --create-dirs "https://raw.githubusercontent.com/G1Joshi/Agent-Skills/main/skills/tools/iterm2/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/iterm2/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How iterm2 Compares

Feature / Agent	iterm2	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

iTerm2 macOS terminal emulator. Use for terminal work.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# iTerm2

iTerm2 is the power-user terminal for Mac. v3.5/3.6 (2025) adds **AI Integration** (OpenAI key) and a built-in **Web Browser** panel.

## When to Use

- **macOS Power User**: Split panes, hotkey window (Quake style), search.
- **Remote Integration**: Shell integration allows downloading files via drag-drop from SSH.

## Core Concepts

### Profiles

Define colors, fonts, and keyboard behavior per environment.

### Triggers

Regex that watches output and performs actions (e.g., highlight "Error", run a script, ring incomplete).

### Tmux Integration

`tmux -CC` makes remote tmux sessions appear as native iTerm2 windows/tabs.

## Best Practices (2025)

**Do**:

- **Use Shell Integration**: Install it to enable features like "Status Bar" on the prompt line.
- **Use "Composer"**: Like Warp, iTerm2 has an input composer window (`Cmd+Shift+C`).
- **Map Option to Meta**: Ensure `Option` key acts as `Esc+` for proper Emacs/Vim navigation.

**Don't**:

- **Don't ignore the GPU renderer**: Enable Metal renderer for performance.

## References

- [iTerm2 Documentation](https://iterm2.com/documentation.html)