Um terminal macOS baseado em Ghostty com abas verticais e notificações para agentes de programação com IA
English | 日本語 | Tiếng Việt | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | ភាសាខ្មែរ | Українська
▶ Vídeo de demonstração · O Zen do cmux
## Recursos
Anéis de notificaçãoOs painéis recebem um anel azul e as abas acendem quando agentes de programação precisam da sua atenção |
|
Painel de notificaçõesVeja todas as notificações pendentes em um só lugar, vá direto para a mais recente não lida |
|
Navegador integradoDivida um navegador ao lado do seu terminal com uma API programável portada do agent-browser |
|
Abas verticais + horizontaisA barra lateral mostra o branch do git, status/número do PR vinculado, diretório de trabalho, portas em escuta e texto da última notificação. Divida horizontal e verticalmente. |
|
SSHcmux ssh user@remote cria um workspace para uma máquina remota. Painéis do navegador são roteados pela rede remota, então localhost simplesmente funciona. Arraste uma imagem para uma sessão remota para fazer upload via scp.
|
|
Claude Code Teamscmux claude-teams executa o modo de companheiros de equipe do Claude Code com um único comando. Os companheiros aparecem como divisões nativas com metadados na barra lateral e notificações. Sem necessidade de tmux.
|
|
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
```bash
brew tap manaflow-ai/cmux
brew install --cask cmux
```
Para atualizar depois:
```bash
brew upgrade --cask cmux
```
Na primeira execução, o macOS pode pedir para você confirmar a abertura de um app de um desenvolvedor identificado. Clique em **Abrir** para continuar.
## Por que o cmux?
Eu executo muitas sessões de Claude Code e Codex em paralelo. Eu estava usando o Ghostty com vários painéis divididos e contando com as notificações nativas do macOS para saber quando um agente precisava de mim. Mas o corpo da notificação do Claude Code é sempre apenas "Claude is waiting for your input" sem contexto, e com abas suficientes abertas eu não conseguia nem ler os títulos mais.
Eu tentei alguns orquestradores de código, mas a maioria era apps Electron/Tauri e o desempenho me incomodava. Eu também prefiro o terminal, já que orquestradores GUI te prendem no fluxo de trabalho deles. Então eu construí o cmux como um app nativo macOS em Swift/AppKit. Ele usa o libghostty para renderização do terminal e lê sua configuração existente do Ghostty para temas, fontes e cores.
As principais adições são a barra lateral e o sistema de notificações. A barra lateral tem abas verticais que mostram o branch do git, status/número do PR vinculado, diretório de trabalho, portas em escuta e o texto da última notificação para cada workspace. O sistema de notificações captura sequências do terminal (OSC 9/99/777) e tem uma CLI (`cmux notify`) que você pode conectar aos hooks de agentes para Claude Code, OpenCode, etc. Quando um agente está esperando, seu painel recebe um anel azul e a aba acende na barra lateral, para que eu possa ver qual precisa de mim entre divisões e abas. Cmd+Shift+U pula para o mais recente não lido.
O navegador integrado tem uma API programável portada do [agent-browser](https://github.com/vercel-labs/agent-browser). Agentes podem capturar a árvore de acessibilidade, obter referências de elementos, clicar, preencher formulários e executar JS. Você pode dividir um painel de navegador ao lado do seu terminal e fazer o Claude Code interagir diretamente com seu servidor de desenvolvimento.
Tudo é programável através da CLI e socket API — criar workspaces/abas, dividir painéis, enviar teclas, abrir URLs no navegador.
## O Zen do cmux
O cmux não é prescritivo sobre como os desenvolvedores usam suas ferramentas. É um terminal e navegador com uma CLI, e o resto é com você.
O cmux é uma primitiva, não uma solução. Ele te dá um terminal, um navegador, notificações, workspaces, divisões, abas e uma CLI para controlar tudo isso. O cmux não te força a usar agentes de programação de uma forma específica. O que você constrói com as primitivas é seu.
Os melhores desenvolvedores sempre construíram suas próprias ferramentas. Ninguém descobriu ainda a melhor forma de trabalhar com agentes, e as equipes construindo produtos fechados definitivamente também não. Os desenvolvedores mais próximos de suas próprias bases de código vão descobrir primeiro.
Dê a um milhão de desenvolvedores primitivas combináveis e eles coletivamente encontrarão os fluxos de trabalho mais eficientes mais rápido do que qualquer equipe de produto poderia projetar de cima para baixo.
## Documentação
Para mais informações sobre como configurar o cmux, [acesse nossa documentação](https://cmux.com/docs/getting-started?utm_source=readme).
## Atalhos de Teclado
### Áreas de Trabalho
| Atalho | Ação |
|----------|--------|
| ⌘ N | Novo workspace |
| ⌘ 1–8 | Ir para workspace 1–8 |
| ⌘ 9 | Ir para último workspace |
| ⌃ ⌘ ] | Próximo workspace |
| ⌃ ⌘ [ | Workspace anterior |
| ⌘ ⇧ W | Fechar workspace |
| ⌘ ⇧ R | Renomear workspace |
| ⌥ ⌘ E | Editar descrição do workspace |
| ⌘ B | Alternar barra lateral |
| ⌥ ⌘ B | Alternar barra lateral direita |
| ⌘ ⇧ E | Alternar foco da barra lateral direita |
### Superfícies
| Atalho | Ação |
|----------|--------|
| ⌘ T | Nova surface |
| ⌘ ⇧ ] | Próxima surface |
| ⌘ ⇧ [ | Surface anterior |
| ⌃ Tab | Próxima surface |
| ⌃ ⇧ Tab | Surface anterior |
| ⌃ 1–8 | Ir para surface 1–8 |
| ⌃ 9 | Ir para última surface |
| ⌘ W | Fechar surface |
### Painéis Divididos
| Atalho | Ação |
|----------|--------|
| ⌘ D | Dividir à direita |
| ⌘ ⇧ D | Dividir para baixo |
| ⌥ ⌘ ← → ↑ ↓ | Focar painel direcionalmente |
| ⌘ ⇧ H | Piscar painel focado |
### Navegador
Os atalhos de ferramentas do desenvolvedor do navegador seguem os padrões do Safari e podem ser personalizados em `Configurações → Atalhos de Teclado`.
Os atalhos de navegação da paleta de comandos, incluindo ⌃ P, também são personalizáveis e podem ser limpos para que a tecla pressionada chegue ao terminal ativo.
| Atalho | Ação |
|----------|--------|
| ⌘ ⇧ L | Abrir navegador em divisão |
| ⌘ L | Focar barra de endereço |
| ⌘ [ | Voltar |
| ⌘ ] | Avançar |
| ⌘ R | Recarregar página |
| ⌥ ⌘ I | Alternar Ferramentas do Desenvolvedor (padrão Safari) |
| ⌥ ⌘ C | Mostrar Console JavaScript (padrão Safari) |
### Notificações
| Atalho | Ação |
|----------|--------|
| ⌘ I | Mostrar painel de notificações |
| ⌘ ⇧ U | Ir para última não lida |
| ⌥ ⌘ U | Alternar estado de não lida do item atual |
| ⌃ ⌘ U | Marcar item atual como não lido mais antigo e ir para a próxima não lida mais recente |
### Busca
| Atalho | Ação |
|----------|--------|
| ⌘ F | Buscar |
| ⌘ ⇧ F | Buscar no diretório |
| ⌘ G / ⌥ ⌘ G | Buscar próximo / anterior |
| ⌥ ⌘ ⇧ F | Ocultar barra de busca |
| ⌘ E | Usar seleção para busca |
### Terminal
| Atalho | Ação |
|----------|--------|
| ⌘ K | Limpar histórico de rolagem |
| ⌘ C | Copiar (com seleção) |
| ⌘ V | Colar |
| ⌘ + / ⌘ - | Aumentar / diminuir tamanho da fonte |
| ⌘ 0 | Redefinir tamanho da fonte |
### Janela
| Atalho | Ação |
|----------|--------|
| ⌘ ⇧ N | Nova janela |
| ⌘ ⇧ O | Reabrir sessão anterior |
| ⌘ , | Configurações |
| ⌘ ⇧ , | Recarregar configuração |
| ⌘ Q | Sair |
## Builds Noturnos
[Baixar cmux NIGHTLY](https://github.com/manaflow-ai/cmux/releases/download/nightly/cmux-nightly-macos.dmg)
O cmux NIGHTLY é um app separado com seu próprio bundle ID, então roda ao lado da versão estável. Construído automaticamente a partir do último commit em `main` e se atualiza automaticamente via seu próprio feed Sparkle.
Reporte bugs do nightly nas [GitHub Issues](https://github.com/manaflow-ai/cmux/issues) ou em [#nightly-bugs no Discord](https://discord.gg/xsgFEVrWCZ).
## Restauração de sessão
Ao sair, o cmux salva a sessão atual. Ao abrir novamente, o cmux restaura o estado
pertencente ao app:
- Layout de janelas/workspaces/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 não cria checkpoints de estado arbitrário de processos ativos. tmux, vim, shells e
apps de terminal sem suporte reabrem como terminais normais.
Sessões de agentes compatíveis podem ser retomadas quando os hooks salvam um ID de sessão nativo.
Instale os hooks depois de instalar a CLI do agente para que seu binário esteja no `PATH`:
```bash
cmux hooks setup
cmux hooks setup codex
cmux hooks setup --agent opencode
```
`cmux hooks setup` instala os agentes compatíveis que encontra e imprime um resumo
dos agentes ignorados. As integrações de retomada compatíveis incluem Claude Code, Codex,
Grok, OpenCode, Pi, Amp, Cursor CLI, Gemini, Rovo Dev, Copilot, CodeBuddy,
Factory e Qoder. O Claude Code é tratado pelo wrapper Claude do cmux quando a integração
com o Claude está ativada nas Configurações.
Usuários avançados e integrações podem associar um comando personalizado de retomada à
surface de terminal atual. Isso é útil para ferramentas com estado durável próprio,
como sessões tmux ou CLIs de agentes customizados:
```bash
cmux surface resume set --kind tmux --checkpoint work --shell "tmux attach -t work"
cmux surface resume show --json
cmux surface resume clear --checkpoint work
```
A associação fica ligada à surface do cmux. Associações criadas pela CLI pública ou pelo
socket são salvas para inspeção e restauração manual, a menos que você aprove um prefixo de
comando assinado para restauração automática. Os prefixos aprovados também são associados ao
diretório de trabalho e aos valores exatos de ambiente, quando presentes. Revise ou edite as
aprovações em **Configurações > Terminal > Comandos de Retomada**. O cmux só executa
automaticamente associações de retomada que marca como confiáveis, como associações tmux
detectadas a partir de processos ativos ou prefixos aprovados pelo usuário. Chaves de ambiente
sensíveis, como tokens, senhas, segredos e chaves de API, são descartadas antes de salvar uma
associação de retomada.
Para manter os terminais de agentes restaurados inativos em vez de executar automaticamente seus comandos de retomada,
desative **Configurações > Terminal > Retomar Sessões de Agentes ao Reabrir** ou defina isto em
`~/.config/cmux/cmux.json`:
```json
{
"terminal": {
"autoResumeAgentSessions": false
}
}
```
Isso desativa apenas os comandos automáticos de retomada de agentes. O cmux continua restaurando o layout salvo,
os diretórios de trabalho, o histórico de rolagem e o histórico do navegador.
Se você precisar reaplicar manualmente o último snapshot salvo, use:
- `Arquivo > Reabrir Sessão Anterior`
- `⌘ ⇧ O`
- `cmux restore-session`
Nos bastidores, o cmux grava um snapshot versionado em
`~/Library/Application Support/cmux/` e os hooks de agentes gravam mapeamentos de sessão
em `~/.cmuxterm/`. Na restauração, o cmux reconstrói o layout primeiro e depois executa o
comando de retomada nativo do agente compatível quando a retomada automática de agentes está ativada.
Leia o guia completo em
WeChat: Escaneie o código QR para entrar na comunidade.
