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. --plan shows 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 X
From the output of iterm guide.

Other contact: