← ClaudeAtlas

manage-iterm2-agent-windowslisted

Manage iTerm2 windows containing local or remote tmux Codex, Claude Code, and Antigravity CLI sessions. Use when the user asks to inspect or organize agent tabs, unify LOCAL and one or more configured dev servers in one control window, condense or regroup sessions, save or show a window snapshot, list or report which snapshots exist, preserve agent and remote tmux identities and working paths, or resume a saved window context.
louis6178/tabfleet · ★ 0 · AI & Automation · score 67
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