Noções Básicas

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 usá-la em outros terminais, abra a paleta de comandos (⌘⇧P) e execute Comando Shell: Instalar 'cmux' no PATH. A CLI incluída é vinculada em /usr/local/bin, e uma senha de administrador é solicitada se essa pasta exigir.

Ou crie o link simbólico você mesmo:

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"

Tornar o cmux seu terminal padrão

Para abrir links ssh:// e scripts de shell do Finder no cmux em vez do Terminal, escolha cmux > Make cmux the Default Terminal na barra de menus ou execute Make cmux the Default Terminal na paleta de comandos.

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

Esta página foi útil?

Abrir issue