Stats
Links
Categories
iTerm2 terminal control for Claude Code via AppleScript
npx claudepluginhub tinycamera/iterm2-controllerGives Claude Code control over iTerm2 terminals via AppleScript
A Claude Code plugin that gives Claude control over iTerm2 terminals via AppleScript. Create tabs, split panes, send commands, read output, and monitor sessions — all from within Claude Code.
/plugin marketplace add TinyCamera/iterm2-controller
/plugin install iterm2-controller
On first use, macOS will prompt you to allow your terminal to control iTerm2 via AppleScript. Grant this permission — it's a one-time dialog.
On session start, the plugin displays your TTY path. Register it to link your terminal:
iterm_register_session("/dev/ttys004")
| Tool | Description |
|---|---|
iterm_register_session | Link a TTY to the current Claude session |
iterm_list_sessions | List all iTerm2 sessions across windows, tabs, and panes |
iterm_get_session_by_name | Find sessions by fuzzy name match |
iterm_focus_session | Bring a session to the foreground |
iterm_set_session_name | Rename a session |
| Tool | Description |
|---|---|
iterm_new_tab | Create a new tab (optionally with a command and name) |
iterm_split_pane | Split a pane vertically or horizontally |
| Tool | Description |
|---|---|
iterm_send_command | Send a shell command to a session |
iterm_send_keys | Send special keys (Ctrl+C, arrows, Enter, etc.) |
| Tool | Description |
|---|---|
iterm_read_output | Read recent terminal output (last N lines) |
iterm_watch_session | Poll for new output since the last read |
All tools accept a session identifier as a session ID, TTY path, or fuzzy name match.
python3 -m venv .venv
.venv/bin/pip install mcp pydantic httpx
.venv/bin/python3 server.py
MIT