Documentation
¶
Overview ¶
ssq-mux is a PTY multiplexer that enables bidirectional terminal access from multiple sources (e.g., IntelliJ terminal + claude-squad web UI).
Usage:
ssq-mux [options] <command> [args...] ssq-mux --attach <session-name> ssq-mux --list
Options:
-n, --name <name> Custom session name (default: auto-generated from directory) -a, --attach [session] Attach to existing tmux session (interactive picker if no session specified) -l, --list List available claude-squad tmux sessions
Example:
ssq-mux claude ssq-mux -n "api-refactor" claude ssq-mux --name "feature-xyz" aider --model gpt-4 ssq-mux --list # Show available sessions ssq-mux --attach staplersquad_ext_12345 # Reattach to existing session
The multiplexer creates a Unix domain socket at /tmp/ssq-mux-<PID>.sock that claude-squad can discover and connect to for terminal streaming.
Session names are automatically generated from the current directory, command, and PID, e.g., "staplersquad_ext_myproject_claude_12345". The PID suffix ensures uniqueness when running multiple sessions in the same directory. You can override this with -n/--name.
Reattaching to sessions:
After a restart, tmux sessions may still be running but without the streaming socket. Use --list to see available sessions and --attach to reconnect:
ssq-mux --list ssq-mux --attach staplersquad_ext_myproject_claude_12345
Setup for seamless use with IntelliJ:
# Option 1: Shell alias alias claude='ssq-mux claude' # Option 2: PATH override (create ~/bin/claude wrapper) #!/bin/bash exec ssq-mux /usr/local/bin/claude "$@"
Source Files