dsh-wo-tmux

dsh-wo-tmux

A DeepSeek Harness (DSH) plugin: your tmux workflow, wired into the Workspace Overview tab. The plugin knows whether the current workspace's tmux session is live, frozen with tmux-fridge, or resting in cold storage, and one click opens a fresh terminal attached to it: unfreezing or recovering first when needed.

For people who live in named tmux sessions per project and suspend work mid-thought, this closes the gap between the browser harness and the console: no more tmux ls, no more remembering which projects are frozen.

What you get

• Pill in the session header: shows the workspace's tmux session and its state; clicking opens a terminal attached to it (attach, unfreeze, or recover, per state). Hidden for workspaces without a session, or via a toggle in Granular Settings.
• Tmux subtab in Workspace Overview, in two panes:
  • Session (default):
    • a status card: session name, state chip, how it was resolved (explicit link or name convention), attached clients and windows;
    • actions per state: open console, snapshot to cold storage, freeze (with a confirmation; freezing kills the live session), recover, clean snapshot (also confirmed);
    • linking: pin the workspace to any session name (grouped by live, frozen, cold storage), unlink, or create a new session (pre-filled with the workspace basename, auto-linked, opened in a terminal).
  • All sessions: every session the machine knows about, grouped by store: live sessions (open console, freeze, snapshot), frozen sessions (unfreeze), and cold-storage snapshots (recover, clean). Freezing any live session from this pane is how a project gets parked without leaving the harness.
  • The tab polls while it is open: after an action (unfreeze hands off to a terminal and returns before tmux settles) the state chips catch up on their own, no page switching needed.
• Workspace-to-session links survive reboots in ~/.dsh/settings/wo-tmux.json, so colliding basenames (two projects named api) stay unambiguous.

How it resolves a workspace to a session

First match wins:

1. an explicit link from the link store;
2. a tmux session named like the workspace's basename, looked up in the live server, the frozen list, then cold storage;
3. nothing (the tab invites you to create or link).

How it talks to tmux

The host half shells out to the tmux and tmux-fridge CLIs with argument arrays only (no shell interpolation). Open runs the fridge command bare: tmux-fridge detects and launches the terminal for the attach itself and exits, so wrapping it would only flash a window that dies the moment the handoff happens. Only create needs a terminal from us (plain tmux new-session cannot spawn one): $TERMINAL picks the emulator; without it the plugin probes kitty, alacritty, wezterm, gnome-terminal, x-terminal-emulator, and xterm, and detaches the session when none is found. The TMUX_FRIDGE_BIN environment variable overrides the fridge binary location. Storage formats are never read directly: the CLIs are the contract, so tmux-fridge can change its layout freely.

How to install

Requires a DeepSeek Harness checkout and a profile, here web. tmux and tmux-fridge must be on PATH. Clone the dependencies and this plugin into a plugins folder:

mkdir -p ~/dsh-plugins && cd ~/dsh-plugins
git clone https://github.com/joao-paulo-santos/dsh-workspace-overview.git
git clone https://github.com/joao-paulo-santos/dsh-wo-tmux.git

# from the harness checkout
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-workspace-overview
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-wo-tmux

# verify the profile still composes
pnpm dsh --profile web --dump-config

Restart the harness; the Tmux tab appears in Workspace Overview and the pill appears on sessions whose workspace has a session.

Dependencies

• dsh-workspace-overview hosts the subtab and the pill (required; without it the client half stays inactive)
• the tmux binary on PATH (session listing and creation)
• the tmux-fridge binary on PATH (frozen/cold storage and the attach actions); without it the tab still shows live state and a clear "not on PATH" note
• a terminal emulator: $TERMINAL or one of the probed ones; without any, open and create fall back to detached sessions where possible

Plugins dependent on this

(none)

Limitations

• The plugin never embeds a terminal in the browser; it spawns a real terminal window. That is the point.
• One terminal window per click. Attaching twice to the same session is normal tmux and stays your business.
• Name detection covers one session per workspace; many-to-many setups (several sessions for one project) are out of scope, though linking picks the one you care about.