#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:

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.

See the session restore guide for agent hook setup and the supported resume matrix.

#Requisitos

macOS 14.0 ou posterior
Mac com Apple Silicon ou Intel