convez.ai
MCP Server
thinkyou0714

ccmux

thinkyou0714/ccmux

Ver no GitHub
BomPluginScore · de 0 a 100

Claude Code Multiplexer — Zellij × git worktree × Obsidian

Instalação

$npx convez-ai thinkyou0714/ccmux

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 4 dias
Versão
—
Issues abertas
7
Contribuidores
4

README

A tradução para o português deste README ainda está na fila.

ccmux — Claude Code Multiplexer

CodeQL License: MIT Star History Chart

Zellij × git worktree × Obsidian integration for managing parallel Claude Code sessions.

Features

  • ccmux new <name> — Create a session: git worktree + Zellij tab + Claude Code
  • ccmux list — Show active sessions + today's API cost (via ccusage)
  • ccmux close <name> — Close session + write Obsidian handoff note
  • ccmux swap <project> — Hot-swap CLAUDE.md + settings.json to another project
  • ccmux auto [name] — Launch autonomous CC session (detached daemon or Zellij tab)
  • ccmux serve — Run the ccmux HTTP control server
  • ccmux merge <name> — Merge a session's worktree branch back
  • ccmux logs [name] — Tail session logs
  • ccmux prune — Remove stale worktrees + dead sessions
  • ccmux reflect <name> — Generate a reflection/handoff note for a session
  • ccmux dashboard [subcommand] — Open the status dashboard
  • ccmux doctor — Diagnose the ccmux + Zellij + Claude Code environment
  • ccmux 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

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.

Ver o original no GitHub

Bom para

Relacionados