manage-iterm2-agent-windowslisted
Install: claude install-skill louis6178/tabfleet
# Manage iTerm2 Agent Windows
Use the bundled `scripts/session_groups.py` tool for all iTerm2 agent-window
management.
Treat a normal iTerm2 `window_id` as an independent workspace. A window marked
`user.agentControlWindow=LOCAL+<REMOTE>...` is one unified workspace with
independent local and remote partitions. Never directly create, close, move,
or reorder windows outside this tool.
## Inspect
Inspect all windows or only the current window:
```bash
~/.codex/skills/manage-iterm2-agent-windows/scripts/session_groups.py snapshot
~/.codex/skills/manage-iterm2-agent-windows/scripts/session_groups.py \
snapshot --window current
```
Use `origin`, `remote_host`, `tmux_session`, `tmux_window_id`, `title`,
`user_prompt`, `cwd`, `provider`, `agent_session_id`, `transcript_path`, and
active-tab flags to understand each session. Do not move the active tab based
only on an old prompt; account for the user's current conversation.
## Unify LOCAL and configured dev servers
Run only after the user explicitly asks for one control window:
```bash
~/.codex/skills/manage-iterm2-agent-windows/scripts/session_groups.py \
unify --window current --server DEVSERVER
# Repeat --server to select several enabled entries. With no --server,
# every enabled entry in the local server config is selected.
~/.codex/skills/manage-iterm2-agent-windows/scripts/session_groups.py \
unify --window current \
--server DEVSERVER \
--server BUILD-SERVER
```
This resolves logical names through the loca