Seamlessly manage tmux sessions alongside git worktrees — right from VS Code.

🌏 Read this in other languages: English | 한국어 | 简体中文 | 繁體中文 (台灣) | 繁體中文 (香港) | 日本語

Install from VS Marketplace

• Image-aware terminal paste: Cmd+V / Ctrl+Shift+V keeps normal text paste, but auto-inserts an image file path when clipboard has an image.
• Remote-SSH clipboard bridge: local clipboard images can be pasted into remote terminals without manual upload steps.
• Collision-safe session identity: sessions use repo-name + path hash namespace and slug disambiguation for same-name repos and similar paths.
• Legacy-compatible migration: previous session prefixes are still detected when @workdir belongs to the repo.
• No-git fallback visibility: even non-git folders still appear as current project (no git) instead of disappearing from the tree.

If you use git worktree for parallel development and tmux for persistent terminal sessions, you know the pain of manually juggling both. This extension bridges the gap:

• One click to create a worktree + tmux session together
• Tree view showing all worktrees with their tmux status
• Auto-attach to the right tmux session when you open a worktree
• Never lose context — sessions persist even if VS Code closes

Run AI coding agents (Claude Code, Codex, OpenCode, Gemini CLI) inside tmux sessions. Your agent keeps running in the background — reconnect from anywhere, even from a phone via Termux.

🤖 Parallel Development with AI Agents

project/
├── main              → tmux: "myapp/main" (Claude Code refactoring)
├── feature/oauth     → tmux: "myapp/feature-oauth" (manual coding)
└── fix/memory-leak   → tmux: "myapp/fix-memory-leak" (Codex analyzing)

Run independent AI agents on each branch, check results in VS Code. Sessions keep working in the background.

🌐 Remote Server Development Connected to a dev server via SSH:

• Use VS Code Remote-SSH to connect
• Manage branch sessions with TMUX Worktree
• SSH disconnect? tmux sessions persist
• Reconnect from home, café, or phone

📱 Mobile Code Review Access from phone via Termux + SSH:

ssh dev-server
tmux attach -t myapp/feature-oauth

Review AI-written code during your commute.

A dedicated sidebar showing all your git worktrees and their associated tmux sessions at a glance. See session status, pane count, and last activity time.

Create a new git branch + worktree + tmux session in one step. Start working on a new feature instantly.

• Attach in Terminal — open tmux session in VS Code's integrated terminal
• Attach in Editor — embed tmux session as an editor tab
• Auto-attach — automatically connect when opening a worktree folder

Detect and clean up tmux sessions that no longer have matching worktrees. Keep your environment tidy.

• Split panes and create new windows from the context menu
• Copy worktree paths to clipboard
• Open worktrees in new VS Code windows
• Filter sessions by name

• Cmd+V (macOS) / Ctrl+Shift+V (Linux) in terminal first checks clipboard content
• If clipboard has text, it keeps the default paste behavior
• If clipboard has an image, it saves a temporary .png and inserts the file path into terminal
• Works with local sessions and Remote-SSH (webview bridge uploads local clipboard image to remote host)
• Force image-only mode from Command Palette: TMUX: Paste Image from Clipboard

• Session namespace uses repo-name + path hash to avoid collisions between same-name repositories in different directories
• Legacy session names are still detected for compatibility when @workdir points inside the current repo
• Worktrees with colliding slugs are auto-disambiguated (parent folder, then path hash)
• Non-git folders are still shown in the tree as current project (no git)

• v1.1.6: Added image-aware terminal paste for AI CLI workflows (Cmd+V / Ctrl+Shift+V) and a force image paste command. Also improved startup auto-attach sizing stability to reduce occasional small terminal rendering until a manual window resize.
• v1.1.4 - v1.1.5: Improved tmux clipboard reliability by enabling clipboard capabilities and passthrough options during attach.
• v1.1.3: Refactored legacy session-prefix compatibility logic for safer migration.
• v1.1.2: Added slug collision handling and explicit no-git workspace labeling (current project (no git)).

• tmux — must be installed and available in PATH
• git — must be installed and available in PATH
• VS Code 1.85.0+

1. Install the extension
2. Open a git repository in VS Code
3. Click the TMUX icon in the Activity Bar (sidebar)
4. Your existing worktrees and tmux sessions will appear automatically

To create a new task: click the + button in the TMUX panel header, enter a branch name, and you're ready to go.

Repository (root)
├── main              → tmux session: "project-a1b2c3d4_main"
├── feature/login     → tmux session: "project-a1b2c3d4_feature-login"
└── fix/bug-123       → tmux session: "project-a1b2c3d4_fix-bug-123"

Each worktree gets a dedicated tmux session. Session names use a repo namespace (repo-name + path hash) plus a slug, which avoids collisions across same-name repositories in different directories.

• Marketplace
• GitHub Repository
• Report Issues

MIT