iterm
Everything you can do by hand in iTerm2, from the command line, for people and AI agents alike.
- Binary
- A single Rust binary of about 3 MB, with no runtime and no daemon.
- Transport
- iTerm2's official protobuf API over its local Unix socket. Requires Enable Python API in iTerm2's settings.
- Grammar
- One form,
iterm <noun> <verb>, across windows, tabs, panes, agents, layouts and profiles.--planshows what a write would do. - Agents
- Panes form a tree of agents. Spawn them with a task and a git worktree each, wait on them, read their output and message them.
- Status
- Not public yet.
$ iterm guide
see
iterm tree everything: windows, vertical tabs, tabs, panes, agents
iterm pane read X --tail 40 a pane's last lines
iterm agent list agents: provider, model, state
iterm pane wait X --until idle|exit|text~RE
shape
iterm pane new --at @me --side right|down [--cmd C]
iterm pane|tab|vtab set X --name N --color red|orange|…
iterm pane resize X --ratio 0.6
orchestrate
iterm pane new --agent --at @me --side right --worktree
iterm agent msg X --text T · agent wait X · agent merge Xiterm guide.