What problem does it solve?
It solves the problem of reliably operating a live iTerm2 terminal session—sending commands, orienting to what is running, and reading current output and scrollback—without manual tab/pane switching or guessing session state.
Core Features & Use Cases
- Workspace orientation via snapshots: Use app-level snapshotting to identify every session’s name, current directory, foreground process, role label, and last output line in one call.
- Deterministic session interaction: Send text, wait for prompt/command completion patterns (via shell integration references), and read screen content and full scrollback for verification.
- Layout and multi-session control: Create and manage windows, tabs, and split panes; label panes with variables for later discovery; and run tmux -CC workflows through iTerm2.
- Use case: When you open an existing workspace with multiple running services (API server, log tailer, editor), run a snapshot to immediately map what each pane is doing, then send targeted commands to only the correct sessions.
Quick Start
Ask the assistant to run the command cli-anything-iterm2 --json app snapshot to get a machine-readable overview of every iTerm2 session and its current foreground process.