ccmux
thinkyou0714/ccmux
Claude Code Multiplexer — Zellij × git worktree × Obsidian
Instalação
npx convez-ai thinkyou0714/ccmux1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
ccmux — Claude Code Multiplexer
Zellij × git worktree × Obsidian integration for managing parallel Claude Code sessions.
Features
ccmux new <name>— Create a session: git worktree + Zellij tab + Claude Codeccmux list— Show active sessions + today's API cost (via ccusage)ccmux close <name>— Close session + write Obsidian handoff noteccmux swap <project>— Hot-swapCLAUDE.md+settings.jsonto another projectccmux auto [name]— Launch autonomous CC session (detached daemon or Zellij tab)ccmux serve— Run the ccmux HTTP control serverccmux merge <name>— Merge a session's worktree branch backccmux logs [name]— Tail session logsccmux prune— Remove stale worktrees + dead sessionsccmux reflect <name>— Generate a reflection/handoff note for a sessionccmux dashboard [subcommand]— Open the status dashboardccmux doctor— Diagnose the ccmux + Zellij + Claude Code environmentccmux init— Initialize~/.ccmux/config.json
Install (WSL2 / Linux)
git clone https://github.com/thinkyou0714/ccmux
cd ccmux
npm install && npm run build
echo "alias ccmux='node $(pwd)/dist/index.js'" >> ~/.bashrc
source ~/.bashrc
ccmux init
Config (~/.ccmux/config.json)
{
"defaultProject": "think-you-lab",
"projects": {
"think-you-lab": {
"path": "/mnt/c/work/think-you-lab",
"claudeMd": "/mnt/c/work/think-you-lab/lms/CLAUDE.md"
}
},
"obsidian": {
"apiKey": "YOUR_OBSIDIAN_LOCAL_REST_API_KEY",
"baseUrl": "http://localhost:27123"
}
}
Obsidian over HTTPS (TLS)
ccmux verifies the TLS certificate on every Obsidian request, so the Bearer API key can't leak to a man-in-the-middle. If your Obsidian Local REST API serves HTTPS with a self-signed certificate, trust the cert rather than disabling verification:
export NODE_EXTRA_CA_CERTS=/path/to/obsidian-local-rest-api.pem
As a last-resort escape hatch you can set "obsidian": { "allowInsecureTLS": true }
in the config (default false). This skips certificate validation and logs a
warning on every request — only use it on a trusted local network.
Requirements
- Node.js ≥ 22
- Zellij (optional — degrades gracefully without it)
- Claude Code CLI
- ccusage (optional — for cost display)
- Obsidian Local REST API plugin (optional)
Why ccmux?
Most session managers depend on tmux. ccmux is built for Zellij-first workflows with n8n + Obsidian integration — allowing Claude Code to hand off context between sessions automatically.