AO

iTerm2

Open attached tabs in iTerm2 via AppleScript. macOS only.

Slot: terminal · Name: iterm2
macOSSupported
LinuxNot supported
WindowsNot supported

The macOS attach experience. When you run ao open, it opens each session in a new iTerm2 tab (or window, with --new-window).

Setup

Install iTerm2, then:

agent-orchestrator.yaml
terminal: iterm2

No plugin-level config.

How it works

Uses osascript + AppleScript under the hood. Requires runtime: tmux — an iTerm2 tab that's not attached to a tmux window is just a blank shell.

Troubleshooting

  • iTerm2 won't take focus. macOS Accessibility permission needed. System Settings → Privacy & Security → Accessibility → iTerm.
  • "open-iterm-tab: command not found". Reinstall AO (npm install -g @aoagents/ao) — the helper binary lives in the ao package.

Alternatives

If you're not on macOS — or iTerm2 isn't your thing — use terminal: web. The dashboard's xterm.js terminal is identical in feature set.