Primeros pasos

imux es una terminal nativa y ligera de macOS basada en Ghostty para gestionar múltiples agentes de programación con IA. Cuenta con pestañas verticales, un panel de notificaciones y una API de control basada en socket.

Instalación

DMG (recomendado)

Abra el .dmg y arrastre imux a su carpeta de Aplicaciones. imux se actualiza automáticamente vía Sparkle, por lo que solo necesita descargarlo una vez.

Para actualizar después:

curl -L -o ~/Downloads/imux-v4.1.20-macos.dmg https://www.iccjk.com/downloads/imux-v4.1.20-macos.dmg
En el primer inicio, macOS puede pedirle que confirme la apertura de una app de un desarrollador identificado. Haga clic en Abrir para continuar.

Verificar la instalación

Abra imux y debería ver:

  • Una ventana de terminal con una barra lateral de pestañas verticales a la izquierda
  • Un workspace inicial ya abierto
  • La terminal con Ghostty lista para recibir 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.

Configuración de CLI

icc incluye una herramienta de línea de comandos para automatización. Dentro de las terminales de icc funciona automáticamente. Para usar la CLI fuera de icc, cree un enlace simbólico:

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

Luego puede ejecutar comandos como:

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

Actualizaciones automáticas

imux busca actualizaciones automáticamente vía Sparkle. Cuando hay una actualización disponible, verá una indicación de actualización en la barra de título. También puede verificar manualmente a través de imux > Buscar actualizaciones en la barra de menú.

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

Restauración de sesión (comportamiento actual)

Después de reiniciar, imux restaura solo el diseño y los metadatos:

  • Diseño de ventanas, workspaces y paneles
  • Directorios de trabajo
  • Scrollback de terminal (mejor esfuerzo)
  • URL del navegador e historial de navegación
imux aún no restaura el estado de procesos en ejecución. Las sesiones activas de aplicaciones de terminal como Claude Code, tmux y vim no se reanudan después del reinicio de la app.

Requisitos

  • macOS 14.0 o posterior
  • Apple Silicon o Intel Mac