hkuds avatar

Cli Anything Iterm2 Ctl

This is the actual programmatic interface to iTerm2, not documentation or advice about how to use it. It gives Claude direct control over a running iTerm2 instance through Python API commands: sending text to sessions, reading scrollback, splitting panes, managing tmux integration, and setting up multi-pane layouts. The standout feature is `app snapshot`, which returns name, directory, process, role label, and last output line for every session in one call, so Claude can orient itself in an existing workspace without reading full screen contents everywhere. Use this when you want Claude to actually manipulate your terminal setup, coordinate across multiple panes, or work with live command output. It assumes you've enabled iTerm2's Python API in preferences.

skills.sh installs
512
GitHub stars
58.5K
last updated
Aug 21, 2026

Install

$ npx -y skills add hkuds/cli-anything --skill cli-anything-iterm2-ctl --agent claude-code

Installs into .claude/skills of the current project.

Files

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

cli-anything-iterm2 [--json] <group> <command> [OPTIONS] [ARGS]

Always use --json for machine-readable output (required for agent use).

Command Groups

Sponsors

Details

Repository
github.com/hkuds/cli-anything
Categories
Frontend Development, Testing & QA, Automation & Workflows, CLI & Terminal
First seen
Jun 3, 2026

More from hkuds/cli-anything

All 51
1aj-geddes avatarinteraction-designaj-geddes/useful-ai-promptsDesign meaningful interactions and microinteractions. Create delightful user experiences through thoughtful animation, feedback, and responsive interface design510skills.sh installs
2parcadei avatarhook-developerparcadei/continuous-claude-v3Complete Claude Code hooks reference - input/output schemas, registration, testing patterns506skills.sh installs
3freestylefly avatarcanghe-format-markdownfreestylefly/canghe-skillsFormats plain text or markdown files with frontmatter, titles, summaries, headings, bold, lists, and code blocks. Use when user asks to "format markdown", "beau505skills.sh installs
4jezweb avataraccessibilityjezweb/claude-skillsBuild WCAG 2.1 AA compliant websites with semantic HTML, proper ARIA, focus management, and screen reader support. Includes color contrast (4.5:1 text), keyboar505skills.sh installs
5freestylefly avatarremotion-best-practicesfreestylefly/canghe-skillsBest practices for Remotion - Video creation in React503skills.sh installs
6jezweb avatartanstack-tablejezweb/claude-skillsBuild headless data tables with TanStack Table v8. Server-side pagination, filtering, sorting, and virtualization for Cloudflare Workers + D1. Prevents 12 docum502skills.sh installs