How does 'watch session' differ from 'read output'?

Read output fetches a fixed number of visible lines, while watch session tracks your cursor position and only returns the new output generated since your previous call.

Can I monitor a terminal process that is already running?

Yes, by registering the existing session's TTY path using the iterm_register_session tool, you can link an active terminal to Claude for monitoring and control.

What permissions are required to use this skill?

You must grant macOS Automation permissions to allow Claude to communicate with iTerm2 through System Settings > Privacy & Security > Automation.

Can I use this to handle interactive CLI prompts?

Yes, the iterm_send_keys tool allows you to send specific keystrokes or combinations like Enter, Tab, or Ctrl+C to navigate interactive menus and programs.

Does this work on Windows or Linux?

No, this skill specifically uses AppleScript to control iTerm2, making it exclusive to macOS environments where iTerm2 is installed.

iTerm2 Controller

Name: iTerm2 Controller
Author: TinyCamera

byTinyCamera

0•

生产力与工作流

Automates iTerm2 terminal sessions to manage multiple tabs, split panes, and long-running background processes directly from Claude Code.

This skill enables Claude to interact directly with iTerm2 on macOS, providing a powerful interface for orchestrating complex terminal workflows. It allows users to programmatically create new tabs, split panes into specific layouts, send keyboard shortcuts like Ctrl+C, and monitor live command output without switching windows. Whether you're running a local development server, watching test suites, or managing multiple microservices, this skill streamlines environment setup and process monitoring through automated session management and real-time output tracking.

主要功能

01Bi-directional communication for sending commands and reading terminal output

02Automated tab and split-pane creation with custom naming and color-coding

03Fuzzy-matching session management for easy terminal identification and targeting

04Real-time session monitoring with incremental output tracking via watch mode

050 GitHub stars

06Special key support for interactive process control including Ctrl+C and arrow keys

使用场景

01Running and monitoring background processes like dev servers or test watchers

02Setting up a multi-pane development environment with a single command

03Debugging interactive CLI tools by sending specific keystroke sequences remotely

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tinycamera/iterm2-controller using-iterm2

For use in Claude.ai and ChatGPT

主要功能

01Bi-directional communication for sending commands and reading terminal output

02Automated tab and split-pane creation with custom naming and color-coding

03Fuzzy-matching session management for easy terminal identification and targeting

04Real-time session monitoring with incremental output tracking via watch mode

050 GitHub stars

06Special key support for interactive process control including Ctrl+C and arrow keys

使用场景

01Running and monitoring background processes like dev servers or test watchers

02Setting up a multi-pane development environment with a single command

03Debugging interactive CLI tools by sending specific keystroke sequences remotely

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tinycamera/iterm2-controller using-iterm2

For use in Claude.ai and ChatGPT