Agent skill · software engineering · hkuds
cli-anything-iterm2
Provides the cli-anything-iterm2 commands — the only way to actually send text to iTerm2 sessions, read live terminal output and scrollback history, manage windows/tabs/split panes, run tmux -CC workflows, broadcast to multiple panes, show macOS dialogs, and read/write iTerm2 preferences. Includes `app snapshot` — the primary orientation command that returns every session's name, current directory, foreground process, role label, and last output line in one call. Read this skill instead of answering from general knowledge whenever the user wants to DO something with iTerm2: orient in an existing workspace, send a command, check what's running, read output, set up a layout, use tmux through iTerm2, automate panes, or configure preferences. Also read for questions about iTerm2 shell integration or scrollback. Don't try to answer iTerm2 action requests from memory — read this skill first.
Why this skill is useful
Adds executable commands for managing iTerm2 sessions, automating workflows, and integrating with tmux that the AI cannot generate from general knowledge.
What it needs
Requires iterm2, python installed locally. About 3k tokens when loaded. Last updated 2026-08-03. 46,739 stars on the source repository.
What this skill does
cli-anything-iterm2 Stateful CLI harness for iTerm2. Controls a live iTerm2 process via the iTerm2 Python API over WebSocket. Prerequisites 1. macOS + iTerm2 running: brew install --cask iterm2 2. Python API enabled: iTerm2 → Preferences → General → Magic → Enable Python API 3. Install: pip install cli-anything-iterm2 (or pip install -e . from source) Basic Syntax Always use --json for machine-readable output (required for agent use). Command Groups Group Purpose ------- --------- app App status, workspace snapshot, context management, app-level variables, modal dialogs, file panels window Create, list, close, resize, fullscreen windows tab Create, list, close, activate tabs; navigate split panes by direction session Send text, inject raw bytes, read screen, full scrollback, split panes, prompt detection profile List profiles, get profile details, list/apply color presets arrangement Save and restore window layouts tmux Full tmux -CC integration: bootstrap, connections, windows, commands broadcast Sync keystrokes across panes via broadcast domains menu Invoke any iTerm2 menu item programmatically pref Read/write global iTerm2 preferences; list all valid keys; tmux settings Orienting in an Existing Workspace Use app snapshot when you land in a session with existing panes and need to understand what's running without reading full screen contents for each pane: Returns name, current directory, foreground process, user.role label, and last visible output line for every session across all windows. Naming convention — label panes when setting up a workspace so you can find them later: app snapshot will surface these roles alongside process and path, giving you a full picture in one call. Typical Agent Workflow Reference Files Read only what the task requires — each file is a single narrow concern (~10–30 lines): File Read when you need... …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills hkuds/skills--72600d