The tmux model

A dedicated server

Every clishake command targets its own socket. Your normal tmux sessions are never enumerated or touched.

socket   clishake
session  clishake-<project-name>
window   <agent-name>
pane     %N  # stable pane ID on the agent record

Lifecycle mechanics

1. LaunchA detached window starts in the agent’s assigned work directory.
2. Capturepipe-pane appends output to a per-agent log.
3. Preserve exitsremain-on-exit retains the process exit code for reconciliation.
4. Restartrespawn-pane reuses the window with a fresh output pipe.

Attach and detach

$ clishake attach
$ clishake agent focus claude

Inside an agent pane, press F12 to return to the dashboard. Quitting the dashboard or detaching tmux stops nothing.

Process health