Shows only your folder's Claude tmux session as a view you can drag into the
Secondary Side Bar (right), next to your other agentic chats — without
touching the bottom Panel or any of your other terminals.
It does not open a terminal. It mirrors the tmux pane:
reads the screen with tmux capture-pane (refreshed a few times/second)
sends your keystrokes back with tmux send-keys
renders with the same font as your integrated terminal (so Nerd Font /
Powerline prompt glyphs look right)
One tmux session per folder, named tmux_<folder>. The same session is
reachable from the side bar, a panel terminal, or a headless SSH login.
Workflow
Open the project folder over Remote-SSH.
Open the Claude Tmux view in the right side bar.
It shows the current folder's past Claude conversations — click one to
resume it (creates/attaches tmux_<folder> running claude --resume <id>),
or ＋ Start new session.
Click the view and type. Toolbar: 🕘 Attach (switch conversation),
↻ Restart, 🗑 Kill.
Build & install (on the machine where tmux + claude live)
cd claude-tmux-sidebar
npx @vscode/vsce package # -> claude-tmux-sidebar-<version>.vsix
Local VS Code:code --install-extension claude-tmux-sidebar-<version>.vsix
Remote-SSH: copy the .vsix to the lab machine, then in the Remote-SSH
window: Extensions → … → Install from VSIX… (or
code --install-extension /path/on/remote/file.vsix in its terminal).
Then Developer: Reload Window.
First run: a Claude Tmux icon appears in the Activity Bar — drag the view
into the Secondary Side Bar once; VS Code remembers it.
