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-v4.1.20-macos.dmg https://www.iccjk.com/downloads/imux-v4.1.20-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

Pick a default path (important)

Do not open every surface on day one. Choose one primary path for the session:

Terminal agent CLI (recommended for power users): run Claude Code, Codex, Aider, or Cursor Agent CLI as real processes in the workspace terminal.
Agent Chat: streaming in-app LLM with @mentions, slash commands, and reviewable diffs (Cmd+Shift+L).
Supervisor: multi-panel orchestration after you have a one-sentence charter and done criteria — not the place to invent the goal.

Switch from VS Code or Cursor

Open the same git root you used before. Run agents, tests, remote hosts, browser checks, and Git evidence in imux as the daily driver. Use explorers and in-app edit for the full workbench loop without bouncing back to an Electron IDE.

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