{"id":49256576,"url":"https://github.com/pereljon/claude-mux","last_synced_at":"2026-06-06T06:04:12.910Z","repository":{"id":349506141,"uuid":"1202607340","full_name":"pereljon/claude-mux","owner":"pereljon","description":"Claude Code Multiplexer - Persistent Claude Code sessions for all your projects.","archived":false,"fork":false,"pushed_at":"2026-05-04T23:11:21.000Z","size":700,"stargazers_count":4,"open_issues_count":0,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-05T01:21:41.990Z","etag":null,"topics":["claude-code","claude-code-remote"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pereljon.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-06T07:48:28.000Z","updated_at":"2026-05-04T23:11:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pereljon/claude-mux","commit_stats":null,"previous_names":["pereljon/claude-autorc","pereljon/claude-mux"],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/pereljon/claude-mux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pereljon%2Fclaude-mux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pereljon%2Fclaude-mux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pereljon%2Fclaude-mux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pereljon%2Fclaude-mux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pereljon","download_url":"https://codeload.github.com/pereljon/claude-mux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pereljon%2Fclaude-mux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33687722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","claude-code-remote"],"created_at":"2026-04-25T04:06:59.718Z","updated_at":"2026-06-06T06:04:12.903Z","avatar_url":"https://github.com/pereljon.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# claude-mux - Claude Code Multiplexer\n\n**English** · [Español](translations/README.es.md) · [Français](translations/README.fr.md) · [Deutsch](translations/README.de.md) · [Português](translations/README.pt-BR.md) · [日本語](translations/README.ja.md) · [한국語](translations/README.ko.md) · [Italiano](translations/README.it.md) · [Русский](translations/README.ru.md) · [中文](translations/README.zh-CN.md) · [עברית](translations/README.he.md) · [العربية](translations/README.ar.md) · [हिन्दी](translations/README.hi.md)\n\nPersistent Claude Code sessions for all your projects - accessible from anywhere via the Claude mobile app. ***Managed by Claude!***\n\n## Install\n\n```bash\ncurl -fsSL https://github.com/pereljon/claude-mux/releases/latest/download/install.sh | bash\n```\n\nThen start a session:\n\n```bash\nclaude-mux ~/path/to/your/project\n```\n\nThe installer asks if you want a home session at login. If you accept, a protected Claude session launches automatically every time you log in - always reachable from your phone or any Remote Control client, even if you never open terminal.\n\nThat's it! You're in a persistent, session-aware Claude session with Remote Control enabled. **From here, everything is conversational.**\n\n[Homebrew, manual install, and other options](docs/INSTALL.md)\n\n## Why\n\nRemote Control promises Claude Code from anywhere - but without session management, it's a second-class interface even from Claude Desktop:\n\n- **Sessions die** when you close the terminal\n- **Conversation context** doesn't resume automatically\n- **No home base** - nothing is running when you pick up your phone unless you left something open\n- **Remote Control requires a running session** - you can't start one from RC\n- **Slash commands don't work in RC sessions** - no model switching, compacting, or permission mode changes\n- **Starting new projects** - requires manually creating a directory, initializing git, writing a CLAUDE.md, and picking a model\n- **No project management** - no way to see idle projects, or rename, move, and delete projects without breaking history\n\n**claude-mux fixes the session management gap.** It wraps Claude Code in tmux so sessions persist, injects a system prompt so Claude can manage its own sessions, and routes slash commands through tmux so they work over Remote Control. Once a session is running, you manage everything by talking to Claude - in the terminal or the mobile app.\n\n## What You Can Do in a claude-mux Session\n\n- **Manage any session from any session** - start, stop, restart, list, and compact projects using natural language\n- **Access everything from anywhere** - every session has Remote Control enabled, so the Claude mobile app, desktop app, or any remote client is a full interface\n- **Switch models and permission modes** - say \"switch to Haiku\" or \"switch to plan mode\" and Claude handles it, even over Remote Control\n- **Create new projects** - \"create a new project called my-app\" sets up the directory, git, CLAUDE.md, and launches a session. CLAUDE.md templates let you reuse instructions across projects.\n- **Keep sessions alive across reboots** - an optional home session launches at login and stays running; all sessions resume their last conversation automatically\n- **Send slash commands over Remote Control** - Claude routes `/model`, `/compact`, `/clear`, and other slash commands to the running session, working around a [known limitation](https://github.com/anthropics/claude-code/issues/30674)\n- **Preserve conversation history** - renaming, moving, and restarting projects all preserve conversation history automatically\n- **Organize projects** - hide, rename, move, delete, and protect projects from inside any session\n- **GitHub multi-account support** - detects SSH aliases in `~/.ssh/config` and injects them into sessions so Claude uses the right account per project\n- **Multi-CLI-coder support** - auto-creates `AGENTS.md` and `GEMINI.md` symlinks so Codex CLI, Gemini CLI, and others share instructions\n- **Works in any language** - conversational commands are inferred from intent, not keywords\n\n## Talking to Claude\n\nThis is how you use claude-mux day to day. Every session is injected with commands so Claude can manage sessions, switch models, send slash commands, and create new projects - all from inside the conversation. You don't need to remember CLI flags.\n\n```\nYou: \"status\"\nClaude: reports session name, model, permission mode, context usage, and lists all sessions\n\nYou: \"list active sessions\"\nClaude: shows all running sessions with their status\n\nYou: \"start a session for my api-server project\"\nClaude: launches a session in ~/Claude/work/api-server\n\nYou: \"create a new project called mobile-app using the web template\"\nClaude: creates the project directory, initializes git, applies the template, launches a session\n\nYou: \"switch this session to Haiku\"\nClaude: sends /model haiku to itself via tmux\n\nYou: \"compact the api-server session\"\nClaude: sends /compact to the api-server session\n\nYou: \"restart the web-dashboard session\"\nClaude: shuts down and relaunches the session, preserving conversation context\n\nYou: \"switch the api-server session to plan mode\"\nClaude: restarts the session with plan permission mode\n\nYou: \"switch this session to yolo mode\"\nClaude: switches to bypassPermissions mode via Shift+Tab - no restart needed\n\nYou: \"what mode is this session\"\nClaude: reports the current permission mode (default, acceptEdits, plan, bypassPermissions)\n\nYou: \"switch this session to Opus\"\nClaude: sends /model opus to itself via tmux\n\nYou: \"clear this session\"\nClaude: sends /clear to itself, resetting the conversation\n\nYou: \"hide this project\"\nClaude: writes .claudemux-ignore so the project is excluded from -L listings\n\nYou: \"protect this session\"\nClaude: writes .claudemux-protected and sets the tmux marker - shutdown now requires --force\n\nYou: \"is this session protected\"\nClaude: checks for .claudemux-protected in the project folder and reports\n\nYou: \"delete the old-prototype project\"\nClaude: confirms in chat, then moves the project folder to system trash\n\nYou: \"rename this project to my-new-name\"\nClaude: stops the session, renames the folder, migrates conversation history, restarts\n\nYou: \"save this as a template named web\"\nClaude: copies CLAUDE.md to ~/.claude-mux/templates/web.md\n\nYou: \"tip\"\nClaude: prints a tip - same tip all day, or random if TIP_MODE=random is set\n\nYou: \"enable tips\" / \"disable tips\"\nClaude: turns the daily tip on or off across all projects\n\nYou: \"update claude-mux\"\nClaude: warns that all sessions will restart, asks for confirmation, then updates and restarts\n\nYou: \"stop all sessions\"\nClaude: gracefully exits all managed sessions\n\nYou: \"help\"\nClaude: prints the full list of conversational commands\n```\n\n**These commands work in any language.** If you type the equivalent in Spanish, Japanese, Hebrew, or any other language, Claude infers the intent and runs the matching command.\n\n**Type `help` inside any session to see the full command list.**\n\n## More\n\n- [CLI Reference](docs/CLI.md) - full command reference for scripting and automation\n- [Guide](docs/guide.md) - configuration, session details, internals, and troubleshooting\n- [Installation Options](docs/INSTALL.md) - Homebrew, manual install, LaunchAgent setup\n- [FAQ](docs/FAQ.md) - common questions about claude-mux\n- [Known Issues](docs/ISSUES.md) - open bugs, planned features, and resolved issues\n- [Changelog](CHANGELOG.md) - what changed per release\n- [Resilio Sync Guide](docs/resilio-sync-guide.md) - access your project files remotely from iOS, Android, or any device\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpereljon%2Fclaude-mux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpereljon%2Fclaude-mux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpereljon%2Fclaude-mux/lists"}