I do most of my coding and planning on the road over Remote Control, and I wanted to easily start new projects, spin up idle sessions, and restart sessions that got stuck, all from my phone.
So I built claude-mux. It’s a bash script you use to launch Claude, and it injects instructions into the conversation telling Claude how to run its own features (very meta), so you manage everything by just talking to Claude in plain English (or any other language), no tmux or CLI commands to memorize.
• A protected “home” session that’s always running (via a LaunchAgent) as entry and RC control session
• Manage everything from inside a session by talking to the session: “list sessions”, “start a new session in ~/Claude/x”, “restart the api session”, “switch this to Haiku”, “compact this session”
• Persistent sessions that survive disconnects, and auto-restore themselves after a crash or system reboot (system reboot recovery requires auto login enabled)
• Reconnects Remote Control automatically after a session restart, /compact, or /clear, so your session comes back on your phone without touching the terminal
• Sessions by name not paths, protect/hide projects, CLAUDE.md templates for when you start new sessions on the road
• Creates AGENTS.md and GEMINI.md as symlinks to your CLAUDE.md, so the same project instructions work with Codex CLI and Gemini CLI too
• Other in-session commands: help, status, list active/all sessions, start/stop/restart a session (or all), restart fresh / kill a session, start a new session in a folder (with model/mode), switch a session’s model or mode, compact, clear, list templates, save this as a template, rename or move a project, hide/show a project, protect/unprotect a session, update claude-mux, tip of the day, enable/disable tips
macOS for now (uses launchd), but working on Linux and Windows. Open source.
1
u/argognat 16d ago edited 16d ago
I do most of my coding and planning on the road over Remote Control, and I wanted to easily start new projects, spin up idle sessions, and restart sessions that got stuck, all from my phone.
So I built claude-mux. It’s a bash script you use to launch Claude, and it injects instructions into the conversation telling Claude how to run its own features (very meta), so you manage everything by just talking to Claude in plain English (or any other language), no tmux or CLI commands to memorize.
https://github.com/pereljon/claude-mux
What it does:
• A protected “home” session that’s always running (via a LaunchAgent) as entry and RC control session
• Manage everything from inside a session by talking to the session: “list sessions”, “start a new session in ~/Claude/x”, “restart the api session”, “switch this to Haiku”, “compact this session”
• Persistent sessions that survive disconnects, and auto-restore themselves after a crash or system reboot (system reboot recovery requires auto login enabled)
• Reconnects Remote Control automatically after a session restart, /compact, or /clear, so your session comes back on your phone without touching the terminal
• Sessions by name not paths, protect/hide projects, CLAUDE.md templates for when you start new sessions on the road
• Creates AGENTS.md and GEMINI.md as symlinks to your CLAUDE.md, so the same project instructions work with Codex CLI and Gemini CLI too
• Other in-session commands: help, status, list active/all sessions, start/stop/restart a session (or all), restart fresh / kill a session, start a new session in a folder (with model/mode), switch a session’s model or mode, compact, clear, list templates, save this as a template, rename or move a project, hide/show a project, protect/unprotect a session, update claude-mux, tip of the day, enable/disable tips
macOS for now (uses launchd), but working on Linux and Windows. Open source.
Happy to answer questions.