Primeiros passos

Instale ccmux na máquina que executará seus agentes. Após a configuração, crie um projeto e anexe-o à sua primeira sessão.

Requisitos

• macOS, Linux ou Windows por meio de WSL2 (veja o Guia Windows em GitHub — Windows nativo é rastreado como um TODO aberto)
• Um de: Homebrew (macOS/Linuxbrew), curl + um shell POSIX ou Go 1.26+ para o caminho de origem
• tmux e git. Homebrew instala as dependências de tempo de execução; o script de download instala apenas binários ccmux. Corre ccmux setup para verificar dependências ou usar make bootstrap ao compilar a partir da origem.

Instalar

Escolha o script de download ou Homebrew. Use a compilação de origem se quiser desenvolver o próprio ccmux.

Baixar script

curl -fsSL https://ccmux.ai/install | sh
ccmux setup

O script instala os binários da versão mais recente em ~/.local/bin/. Adicione esse diretório ao PATH do seu shell se o instalador solicitar. Você pode inspecionar o script de instalação antes de executá-lo.

O assistente de configuração verifica dependências, ajuda a configurar as CLIs do agente e instala o daemon em segundo plano. Faça login no agente escolhido antes de iniciar uma sessão. Para acesso remoto, conecte seus dispositivos também ao Tailscale.

Homebrew

brew trust --tap skzv/tap
brew install skzv/tap/ccmux
ccmux setup

Confie na torneira uma vez por máquina. Homebrew instala ccmux e suas dependências empacotadas, incluindo tmux, Mosh e ripgrep.

Alternativa: da fonte

mkdir -p ~/Projects && cd ~/Projects
git clone https://github.com/skzv/ccmux.git
cd ccmux && make bootstrap

make bootstrap verifica sua cadeia de construção e se oferece para instalar qualquer coisa que esteja faltando e, em seguida, encadeia em make setup. Use isto se quiser rastrear main ou hackear o próprio ccmux.

Você pode executar novamente o assistente de configuração posteriormente para revisar sua configuração.

Primeira execução

ccmux

O TUI é lançado com um tour inicial. Pressione ? em qualquer tela para obter o mapa de teclado completo.

Atalhos de teclas

Seu primeiro projeto

No TUI: pressione 2 para Projetos, então n para abrir o formulário de novo projeto. Preencha o nome, escolha um agente (Claude / Codex / Antigravity / Cursor / pi / Grok) e pressione Enter. ccmux cria o diretório em projects.root e inicia a sessão do agente imediatamente.

No shell:

ccmux new my-app

Cria o diretório e inicializa a sessão com seu agente padrão. O TUI abre automaticamente na tela inicial, onde você pode conectar com Enter.

Consulte Tutorial 1 para um passo a passo completo.

Próximas etapas

• Gerenciar múltiplas sessões e desconectar sem parar um agente.
• Conecte-se a partir do seu telefone ou adicionar outra máquina.
• Conecte um cliente MCP para inspecionar sessões do seu agente.
• Se a configuração falhar, execute ccmux doctor e siga o guia de manutenção.

Detectou um erro ou algo desatualizado? Edite esta página em GitHub.