Restore every running tmux session into its own VS Code integrated terminal
with one click.
This extension is intentionally small: it discovers existing sessions on the
default tmux server, attaches to them, and lets you rename them from the
sidebar. It never creates or kills a tmux session.
Features
One-click restore from the Restore tmux status bar button
Automatic restore shortly after the extension starts
Tmux Activity Bar view listing sessions, window counts, and attach status
Click a session to open it or focus its existing terminal
Right-click a session and choose Rename Session to rename both the tmux
session and its open VS Code terminal tab
Click the trash icon on a session to kill it after a confirmation prompt;
this also closes its open VS Code terminal tab
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
Connect to your local or Remote SSH workspace.
Open the Tmux view in the Activity Bar to browse sessions.
Click a session to open or focus it, or click Restore tmux in the status
bar to restore every session.
To rename a session, right-click it and choose Rename Session.
To terminate a session and everything running in it, click its trash icon
and confirm Kill Session.
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 都运行在远程主机。
在左侧会话上右键选择 Rename Session,会同步执行 tmux
rename-session,并更新已打开的 VS Code 终端名称。
点击会话旁的垃圾桶并确认后,会执行 tmux kill-session,终止会话内
的全部进程,并关闭对应的 VS Code 终端标签。