Manage all your CLI coding agent sessions without leaving your IDE.
- The sidebar has a broader visual refresh with cleaner group panels and more polished session cards.
- Agent and command sections behave better now in denser layouts.
- Grouped sessions are easier to scan with clearer connectors and smoother expand/collapse behavior.
Full release notes: CHANGELOG.md
2026-04-14.VSmux.+.AMX.quick.demo.4.mp4
This extension is for you if:
- You like to code using multiple agent CLIs in parallel.
- You don't want to be locked into a tool like conductor or superset or w/e.
- You don't want to be missing out on the new features that are coming to the CLIs first.
- You also love to be close to the code for some projects and review changes in your favorite editor (VS Code/Cursor/Antigravity/etc.)
- Like to use VS Code to edit the md files and prompts (ctrl+g) before sending them to the agent cli.
Then this is the extension for you! You get a very nice interface to work with your agents without having to jump between the editor and the ADE tool.
Inspired by Antigravity agent panel, Codex app, T3Code, CMux, and Superset + many more.
- Multiplexed Split Views — Split your workspace into multiple panes (e.g., view 2 up to 9 sessions at once) to monitor and interact with several tasks simultaneously, complete with zoom functionality for easier reading.
- Unified Session Search & History — Quickly search across all your sessions from various tools (WSL, Cloud Code, Codex) in one centralized location, rather than hunting through different tabs.
- Session Management & Organization — Group, sort manually, or organize your sessions by recent activity to maintain a tidy workspace.
- Session Resumption — Click on any past session from the history to instantly reload it and pick up exactly where you left off with the original AI agent.
- Quick Search & Launch — Start typing the name of a closed session to quickly locate and reload it using just your arrow keys and the Enter button.
- Session Forking — Branch off from an active session to retain its current context, allowing you to explore a new task or idea in a separate pane without altering the original chat.
- RAM/Resource Saver (Sleep Mode) — Put inactive sessions to sleep to instantly free up memory (noted as roughly a 25% drop in RAM usage), ensuring background tasks don't slow down your machine.
- Customizable AI Agents — Add, configure, and modify distinct profiles for various AI models. You can set up custom paths, run different agents side-by-side, or create specific profiles (like "work" vs. "personal").
- Cross-Agent Context Handoff — Transfer the context of an active conversation from one AI model (e.g., GPT) directly to another (e.g., Claude) to continue the work seamlessly.
- Custom Action Buttons — Map any terminal command to a clickable, draggable button. These custom actions can be configured to execute commands automatically, play a notification sound upon completion, or close when finished.
- Integrated Browser — Open web environments (like your localhost) directly within a VSmux pane. The browser remembers login states and includes a DevTools console, allowing you to select and send specific HTML elements directly to your AI agents.
- Automated Git Operations — Built-in actions to automatically generate commit messages and push code changes.
- Code Change Monitoring — Keep an eye on the codebase modifications your agents are making in a dedicated bottom-left panel while simultaneously directing other agents on separate tasks.
- Customizable Settings — A robust settings menu that allows you to heavily configure the extension to fit your specific workflow preferences.
- Open the Command Palette.
- Run
VSmux: Open Workspace. - Create your first session.
- Use the sidebar and hotkeys to change the visible split count and jump between sessions and groups.
If you are on macOS, turn on VS Code's window.nativeTabs setting.
This makes it much easier to switch between projects, repos, and worktrees because each VS Code window can live in the same native tab strip. Instead of juggling separate windows, you can keep multiple VSmux workspaces open and move between them quickly with the normal macOS tab workflow.
Enable SCM > Repositories: Explorer, and make sure SCM > Repositories: Selection Mode is set to single.
This exposes repository artifacts directly inside the Source Control UI, including branches, stashes, tags, and worktrees. It makes creating and managing Git worktrees much easier from the VS Code UI, without needing to drop into the terminal for every worktree action.
This lets you write your prompt inside your editor instead strugling with the annoying input box that these AI tools provide. No more [50 lines pasted] nonsense. Paste all the lines you want and even select parts of them and use inline AI to edit those.
Gist on how to do this
| Setting | Description |
|---|---|
VSmux.backgroundSessionTimeoutMinutes |
Controls how long detached background sessions stay alive after the last VSmux window disconnects |
VSmux.sidebarTheme |
Changes the sidebar theme preset |
VSmux.showCloseButtonOnSessionCards |
Shows or hides the close button on session cards |
VSmux.sendRenameCommandOnSidebarRename |
Stages /rename <new name> in the terminal when you rename from the sidebar |
- Create, rename, and close terminal sessions from the sidebar
- Session groups — organize sessions into up to 4 named groups, rename groups, and drag sessions between them
- Drag-and-drop reordering — reorder sessions within and across groups, reorder command buttons
- Session aliases — each session gets an auto-generated word alias (Atlas, Beacon, Comet, etc.)
- Previous session history — closed sessions are archived (up to 200) and can be browsed or restored from a modal
- Configurable visible count — show 1, 2, 3, 4, 6, or 9 sessions at once
- Session slot hotkeys — jump to any session slot with Cmd+Alt+1–9
- Group focus hotkeys — switch between groups with Cmd/Ctrl+Alt+Shift+1–4
- Directional focus navigation — move focus up/right/down/left across sessions with Cmd/Ctrl+Alt+Shift+Arrow keys
- Split count hotkeys — set 1, 2, 3, 4, 6, or 9 visible splits with the Cmd/Ctrl+Alt+S chord
- Built-in agent buttons — one-click launch for T3 Code, Codex, Claude Code, OpenCode, and Gemini
- Custom agents — add your own agent launchers with custom commands and names
- Agent icon detection — session cards show the agent logo watermark based on what's running
- Edit and delete agents — right-click context menu on agent buttons
- Sidebar command buttons — quick-launch buttons for Dev, Build, Test, Setup (or your own)
- Custom commands — create commands with a name, shell command, and optional close-on-exit behavior
- Drag-and-drop reordering — reorder command buttons in the sidebar
- Edit and delete commands — right-click context menu on command buttons
- Three activity states — idle, working, and attention indicators on session cards
- Claude Code title detection — automatically detects Claude Code idle/working state from terminal title
- Shell integration — detects agent start/stop lifecycle events via control sequences
- Codex log pattern matching — parses Codex CLI log output for task_started/task_complete events
- Completion bell — plays a sound when an agent finishes (toggle per project from the sidebar)
- 10 completion sounds — Arcade, African, Afrobeat, EDM, Come Back To The Code, Glass, Ping, Shamisen, Superset Doo-Wap, Superset Quick
- Embedded T3 sessions — T3 Code runs directly inside the VSmux sidebar as a webview
- T3 activity monitoring — WebSocket connection to local T3 runtime tracks thread activity in real time
- T3 session lifecycle — automatic supervision, sync, and management of T3 sessions
- 11 sidebar theme presets — Auto, Plain, Dark Green/Blue/Red/Pink/Orange, Light Blue/Green/Pink/Orange
- Auto theme — follows the active VS Code theme (dark or light)
| Action | macOS | Windows/Linux |
|---|---|---|
| Focus session slot 1–9 | Cmd+Alt+1–9 | Ctrl+Alt+1–9 |
| New session | Cmd+Alt+N | Ctrl+Alt+N |
| Open settings | Cmd+Alt+, | Ctrl+Alt+, |
| Change sidebar | Cmd+Alt+B | Ctrl+Alt+B |
| Focus group 1–4 | Cmd+Alt+Shift+1–4 | Ctrl+Alt+Shift+1–4 |
| Focus up/right/down/left | Cmd+Alt+Shift+Arrow | Ctrl+Alt+Shift+Arrow |
| Rename active session | Cmd+Alt+R | Ctrl+Alt+R |
| Show 1/2/3/4/6/9 splits | Cmd+Alt+S, then 1/2/3/4/6/9 | Ctrl+Alt+S, then 1/2/3/4/6/9 |
- Sidebar rename → terminal rename — renaming from the sidebar optionally stages
/rename <name>in the terminal - Cmd+click or middle-click to close — close sessions without needing a visible close button
- Configurable close button visibility — show/hide close buttons on session cards
- Configurable hotkey label visibility — show hotkey labels on cards always or only on hover
- Background session timeout — configurable timeout for detached background sessions (or keep alive forever)
- Debug panel — inspect terminal workspace state and layout operations in real time
- Companion app — works with agent-manager-x for a floating macOS status bar
The T3 embed frontend is intentionally local-only and gitignored.
Use the dedicated update/setup guide here:
That document is the current source of truth for:
- refreshing the vendored
t3codeversion from upstreammain - rebuilding the local embed bundle
- testing the update safely in a separate worktree
- avoiding the protocol/runtime issues that broke earlier attempts
VSmux works great with my other tool that shows all running agent sessions in a mini floating bar on macOS (with running/waiting/done indicators). Check it out here: https://github.com/maddada/agent-manager-x
Contributions welcome 🙏🏻