Tmux Restore All

Restore every running tmux session into its own VS Code integrated terminal with one click.

This extension is intentionally small and safe: it discovers existing sessions on the default tmux server and attaches to them. It never creates, renames, or kills a tmux session.

Features

• One-click restore from the Restore tmux status bar button
• Tmux Activity Bar view listing sessions, window counts, and attach status
• Click a session to open it or focus its existing terminal
• Open every session at once from the sidebar title action
• Clean terminal labels that use the session name without an extra prefix
• Manual refresh action for sessions created outside VS Code
• One integrated terminal per running tmux session
• Remote SSH support: tmux runs on the remote workspace host
• Reuses terminals that are already open
• Handles session names containing spaces or non-ASCII characters
• Leaves every tmux session running when VS Code disconnects
• No telemetry and no network access

Requirements

• tmux must be installed and available on PATH on the workspace host.
• For Remote SSH, install the extension on the SSH host when VS Code prompts you to choose an installation target.

Usage

1. Connect to your local or Remote SSH workspace.
2. Open the Tmux view in the Activity Bar to browse sessions.
3. Click a session to open or focus it, or click Restore tmux in the status bar to restore every session.
4. The extension runs tmux list-sessions and opens each discovered session in a separate integrated terminal.

You can also run Tmux: Restore All Sessions from the Command Palette.

Optional shortcut:

• macOS: Cmd+Option+R
• Windows/Linux: Ctrl+Alt+R

Running the command again does not duplicate terminals that are already open.

Scope

The extension reads sessions from the default tmux server. It does not discover sessions created with a custom socket via tmux -L or tmux -S.

简体中文

一键读取当前机器上已有的全部 tmux 会话，并在 VS Code 中为每个会话打开一个 独立集成终端。

• 点击底部状态栏的 Restore tmux 即可恢复全部会话。
• 左侧 Tmux 面板会显示会话名称、窗口数和连接状态。
• 点击一个会话即可打开它；如果已经打开，则直接跳到对应终端。
• 点击侧边栏标题栏的“打开全部”按钮，可以一次恢复所有会话。
• Remote SSH 模式下，扩展和 tmux 都运行在远程主机。
• 扩展只执行查询和 attach，不会创建、重命名或删除 tmux 会话。
• 已经打开的同名终端不会被重复创建。

License

MIT