Primeiros Passos

O cmux é um terminal macOS nativo e leve, construído sobre o Ghostty para gerenciar múltiplos agentes de código com IA. Ele possui abas verticais, um painel de notificações e uma API de controle baseada em socket.

Instalação

DMG (recomendado)

Baixar para Mac

Abra o .dmg e arraste o cmux para a pasta Aplicativos. O cmux se atualiza automaticamente via Sparkle, então você só precisa baixar uma vez.

Homebrew

brew tap manaflow-ai/cmux
brew install --cask cmux

Para atualizar depois:

brew upgrade --cask cmux

Na primeira execução, o macOS pode pedir para confirmar a abertura de um app de um desenvolvedor identificado. Clique em Abrir para continuar.

Verificar instalação

Abra o cmux e você deve ver:

Uma janela de terminal com uma barra lateral de abas verticais à esquerda
Um workspace inicial já aberto
O terminal Ghostty pronto para entrada

Configuração da CLI

O cmux inclui uma ferramenta de linha de comando para automação. Dentro dos terminais do cmux, funciona automaticamente. Para usar a CLI de fora do cmux, crie um link simbólico:

sudo ln -sf "/Applications/cmux.app/Contents/Resources/bin/cmux" /usr/local/bin/cmux

Depois você pode executar comandos como:

cmux list-workspaces
cmux notify --title "Build Complete" --body "Your build finished"

Atualizações automáticas

O cmux verifica atualizações automaticamente via Sparkle. Quando uma atualização estiver disponível, você verá um indicador de atualização na barra de título. Você também pode verificar manualmente via cmux > Verificar Atualizações na barra de menus.

Restauração de sessão (comportamento atual)

Após reinício, o cmux restaura apenas layout e metadados:

Layout de janelas, workspaces e painéis
Diretórios de trabalho
Histórico de rolagem do terminal (melhor esforço)
URL do navegador e histórico de navegação

O cmux ainda não restaura o estado de processos em execução. Sessões ativas de aplicativos de terminal como Claude Code, tmux e vim não são retomadas após reinício do app.

Requisitos

macOS 14.0 ou posterior
Mac com Apple Silicon ou Intel