# 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](https://cmux.com/pt-BR/download/confirmation?dl=1)

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](https://cmux.com/pt-BR/docs/session-restore) for agent hook setup and the supported resume matrix.

## Requisitos

-   macOS 14.0 ou posterior
-   Mac com Apple Silicon ou Intel

Canonical: https://cmux.com/pt-BR/docs/getting-started

Documentation index: https://cmux.com/llms.txt