Create a shared tmux session for collaboration between Claude and user.
Create a persistent tmux session for collaborative work between you and the user. Use this for interactive debugging, pair programming, or when you need to hand off control while maintaining context.
/plugin marketplace add thamam/A2X-marketplace/plugin install thamam-thh10x-plugins-thh10x@thamam/A2X-marketplaceCreate a shared tmux session for collaboration between Claude and user.
/shared-session debug # Create session named "debug"
/shared-session dev-work # Create session named "dev-work"
/shared-session monitoring tail -f app.log # Session with command
This command creates a persistent tmux session that both Claude and the user can interact with. The user can attach to the session to take control, work interactively, and detach when done. Claude can monitor the session and read output in the background.
This is ideal for collaborative debugging, pair programming, and situations where you want to hand off control to the user while maintaining context.
# Create empty session for general work
/shared-session dev-work
# Create debugging session
/shared-session debug-auth
# Create session with running server
/shared-session server npm run dev
# Create monitoring session
/shared-session logs tail -f /var/log/app.log
# Production investigation
/shared-session prod-debug ssh prod-server
# Database session
/shared-session db-client psql -U postgres
# Build monitoring
/shared-session build-watch npm run build:watch
Use this command when you need to:
The command will:
tmux attach command for the userAfter creating a shared session, the user can:
Attach to session:
tmux attach -t session-name
Detach from session:
Ctrl+B, then press DCheck if session exists:
tmux ls
Kill session when done:
tmux kill-session -t session-name
/create-terminal - Create a regular (non-shared) terminalcollaborative-debug skill - For interactive debugging workflowsattach_user_to_session tool - Prepare existing session for user attachmentbrew install tmux (macOS) or sudo apt install tmux (Linux)User: "I need to debug the API authentication"
Claude: "I'll create a shared debugging session."
[Runs: /shared-session debug-auth python -m pdb api/auth.py]
Claude: "Created shared session 'debug-auth'.
To attach:
tmux attach -t debug-auth
I've started the Python debugger. You can now:
- Set breakpoints with 'b <line>'
- Step through with 'n' (next) or 's' (step into)
- Print variables with 'p <variable>'
When done, detach with: Ctrl+B, then D"
[User attaches, debugs, detaches]
[Claude reads session output]
Claude: "I can see from your debugging session that the issue
is in the token validation logic at line 145..."
Shared sessions operate in shared mode, meaning:
Install tmux:
# macOS
brew install tmux
# Linux
sudo apt install tmux
The session name is already in use. Either:
tmux kill-session -t session-nameWhen running tmux ls, no sessions found means:
/shared-sessionIf the command fails:
which tmux)When invoked, this command:
create_shared_session MCP toolman tmux or https://github.com/tmux/tmux/wikicollaborative-debug skill for debugging workflowsterminal-automation skill for automated workflows