Wezcld

 ██╗    ██╗ ███████╗ ███████╗  ██████╗ ██╗     ██████╗
 ██║    ██║ ██╔════╝ ╚══███╔╝ ██╔════╝ ██║     ██╔══██╗
 ██║ █╗ ██║ █████╗     ███╔╝  ██║      ██║     ██║  ██║
 ██║███╗██║ ██╔══╝    ███╔╝   ██║      ██║     ██║  ██║
 ╚███╔███╔╝ ███████╗ ███████╗ ╚██████╗ ███████╗██████╔╝
  ╚══╝╚══╝ ╚══════╝ ╚══════╝  ╚═════╝ ╚══════╝╚═════╝

[](https://github.com/afewyards/wezcld/releases/latest)

**WezTerm it2 shim for Claude Code agent teams**


Why

Claude Code uses iTerm2 split panes to manage agent teams. wezcld intercepts `it2` CLI commands and translates them to WezTerm CLI calls, letting you use native WezTerm splits instead of iTerm2.

Install

curl -fsSL https://github.com/afewyards/wezcld/releases/latest/download/install.sh | sh

Usage

Launch Claude Code with WezTerm integration:

wezcld

When running outside WezTerm, `wezcld` automatically falls back to plain `claude`.

How it works

**Architecture:**

• wezcld launcher: Sets TERM_PROGRAM=iTerm.app and puts the shim's bin/ directory first in PATH, then launches Claude with --teammate-mode tmux
• bin/it2 shim: Intercepts it2 CLI commands and translates them to real wezterm cli calls
• Grid layout: Agent panes are arranged in a 3-column grid, with the leader pane kept at the bottom

Supported commands

Command	WezTerm action
--version / app version	Returns it2 0.2.3
session split [-v]	wezterm cli split-pane (grid layout)
session run -s	wezterm cli send-text --pane-id
session close -s	wezterm cli kill-pane --pane-id
session list	Minimal session table
All other commands	Silent success (exit 0)

Requirements

• wezterm CLI (included with WezTerm)
• POSIX-compatible shell (bash, zsh, dash, ash)
• Claude Code (the CLI tool f