ccmux 2.0.0__tar.gz

ccmux-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 TheHumbleTransistor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ccmux-2.0.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: ccmux
+Version: 2.0.0
+Summary: Claude Code Multiplexer - Manage multiple Claude Code instances
+Author: Ray Kampmeier
+License: MIT
+Project-URL: Homepage, https://github.com/TheHumbleTransistor/ccmux
+Project-URL: Repository, https://github.com/TheHumbleTransistor/ccmux
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cyclopts>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: textual>=1.0.0
+Requires-Dist: tomli>=1.0.0; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Dynamic: license-file
+
+# ccmux
+
+<!-- TODO: add demo GIF -->
+<!-- <img src="docs/demo.gif" alt="ccmux demo" width="800"> -->
+
+A streamlined terminal-UI for juggling concurrent Claude Code sessions.
+
+## Features
+
+- **Visual sidebar** — see all sessions at a glance; red highlights tell you instantly when Claude needs your attention
+- **CLI session management** — create, list, activate, remove sessions from the terminal
+- **Git worktree isolation** — spin up duplicate sessions on isolated branches; use  `ccmux.toml` files to add additional steps when spinning up worktrees, such as setting up untracked build dependencies 
+
+## Installation
+
+```bash
+git clone git@github.com:TheHumbleTransistor/ccmux.git
+pip install ./ccmux
+```
+
+## Quick Start
+
+```bash
+ccmux             # auto-creates a session for the current directory or attaches to an existing one
+ccmux new         # create a new session from the current directory's repo
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| *(default)* | Auto-attach to existing session or create one |
+| `new [NAME]` | Create a new session (add `-w` for worktree) |
+| `list` | List all sessions with status and branch info |
+| `attach` | Attach to the ccmux tmux session |
+| `activate [NAME]` | Reopen Claude Code in a session's tmux window |
+| `deactivate [NAME]` | Close tmux window (keeps session) |
+| `remove [NAME]` | Permanently delete a session |
+| `rename OLD NEW` | Rename a session |
+| `kill` | Kill entire ccmux session |
+| `which` | Print current session name (useful for scripting) |
+| `detach` | Detach from tmux |
+| `export-tmux-config` | Export tmux config to a file |
+
+## Worktree Configuration
+
+Drop a `ccmux.toml` in your repo root to run commands after worktree creation:
+
+```toml
+[worktree]
+post_create = [
+    "ln -s $CCMUX_REPO_ROOT/node_modules $CCMUX_INSTANCE_PATH/node_modules",
+    "cp $CCMUX_REPO_ROOT/.env $CCMUX_INSTANCE_PATH/.env",
+]
+```
+
+Commands run inside the new worktree with these environment variables:
+
+| Variable | Description |
+|----------|-------------|
+| `CCMUX_REPO_ROOT` | Absolute path to the main repository |
+| `CCMUX_INSTANCE_PATH` | Absolute path to the new worktree |
+| `CCMUX_INSTANCE_NAME` | Name of the new instance |
+| `CCMUX_SESSION` | ccmux tmux session name |
+
+## Contributing
+
+```bash
+git clone git@github.com:TheHumbleTransistor/ccmux.git
+cd ccmux
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+PRs welcome — open an issue first for large changes.
+
+## License
+
+MIT — see [LICENSE](LICENSE)

ccmux-2.0.0/README.md

@@ -0,0 +1,79 @@
+# ccmux
+
+<!-- TODO: add demo GIF -->
+<!-- <img src="docs/demo.gif" alt="ccmux demo" width="800"> -->
+
+A streamlined terminal-UI for juggling concurrent Claude Code sessions.
+
+## Features
+
+- **Visual sidebar** — see all sessions at a glance; red highlights tell you instantly when Claude needs your attention
+- **CLI session management** — create, list, activate, remove sessions from the terminal
+- **Git worktree isolation** — spin up duplicate sessions on isolated branches; use  `ccmux.toml` files to add additional steps when spinning up worktrees, such as setting up untracked build dependencies 
+
+## Installation
+
+```bash
+git clone git@github.com:TheHumbleTransistor/ccmux.git
+pip install ./ccmux
+```
+
+## Quick Start
+
+```bash
+ccmux             # auto-creates a session for the current directory or attaches to an existing one
+ccmux new         # create a new session from the current directory's repo
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| *(default)* | Auto-attach to existing session or create one |
+| `new [NAME]` | Create a new session (add `-w` for worktree) |
+| `list` | List all sessions with status and branch info |
+| `attach` | Attach to the ccmux tmux session |
+| `activate [NAME]` | Reopen Claude Code in a session's tmux window |
+| `deactivate [NAME]` | Close tmux window (keeps session) |
+| `remove [NAME]` | Permanently delete a session |
+| `rename OLD NEW` | Rename a session |
+| `kill` | Kill entire ccmux session |
+| `which` | Print current session name (useful for scripting) |
+| `detach` | Detach from tmux |
+| `export-tmux-config` | Export tmux config to a file |
+
+## Worktree Configuration
+
+Drop a `ccmux.toml` in your repo root to run commands after worktree creation:
+
+```toml
+[worktree]
+post_create = [
+    "ln -s $CCMUX_REPO_ROOT/node_modules $CCMUX_INSTANCE_PATH/node_modules",
+    "cp $CCMUX_REPO_ROOT/.env $CCMUX_INSTANCE_PATH/.env",
+]
+```
+
+Commands run inside the new worktree with these environment variables:
+
+| Variable | Description |
+|----------|-------------|
+| `CCMUX_REPO_ROOT` | Absolute path to the main repository |
+| `CCMUX_INSTANCE_PATH` | Absolute path to the new worktree |
+| `CCMUX_INSTANCE_NAME` | Name of the new instance |
+| `CCMUX_SESSION` | ccmux tmux session name |
+
+## Contributing
+
+```bash
+git clone git@github.com:TheHumbleTransistor/ccmux.git
+cd ccmux
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+PRs welcome — open an issue first for large changes.
+
+## License
+
+MIT — see [LICENSE](LICENSE)

ccmux-2.0.0/ccmux/__init__.py

@@ -0,0 +1,3 @@
+"""Claude Code Multiplexer - Manage multiple Claude Code instances."""
+
+__version__ = "2.0.0"

ccmux-2.0.0/ccmux/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running ccmux as a module: python -m ccmux"""
+
+from ccmux.cli import main
+
+if __name__ == "__main__":
+    main()