Primeiros Passos

O imux é 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)

Download for macOS

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

Para atualizar depois:

curl -L -o ~/Downloads/imux-v2.4.1-macos.dmg https://www.iccjk.com/downloads/imux-v2.4.1-macos.dmg

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 imux 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 icc inclui uma ferramenta de linha de comando para automação. Dentro dos terminais do icc, funciona automaticamente. Para usar a CLI de fora do icc, crie um link simbólico:

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

Depois você pode executar comandos como:

icc --help
icc notify --title "Build Complete" --body "Your build finished"

Atualizações automáticas

O imux 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 imux > Verificar Atualizações na barra de menus.

https://www.iccjk.com/downloads/appcast.xml
https://www.iccjk.com/downloads/latest.json

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

Após reinício, o imux 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 imux 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