はじめに

imuxはGhosttyベースの軽量なネイティブmacOSターミナルで、複数のAIコーディングエージェントを管理するために設計されています。縦タブ、通知パネル、socketベースの制御APIを搭載しています。

インストール

DMG（推奨）

.dmgを開き、imuxをアプリケーションフォルダにドラッグしてください。imuxはSparkle経由で自動更新されるため、ダウンロードは一度だけで済みます。

後で更新する場合：

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

初回起動時、macOSが確認済みの開発者からのアプリを開くことの確認を求める場合があります。開くをクリックして続行してください。

インストールの確認

imuxを開くと、以下が表示されるはずです：

左側に縦タブサイドバーがあるターミナルウィンドウ
既に開かれた1つのワークスペース
入力可能なGhosttyベースのターミナル

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.

CLIセットアップ

iccには自動化用のコマンドラインツールが含まれています。iccターミナル内では自動的に動作します。iccの外部からCLIを使用するには、シンボリックリンクを作成してください：

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

これで以下のようなコマンドを実行できます：

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

自動更新

imuxはSparkle経由で自動的に更新を確認します。更新が利用可能な場合、タイトルバーに更新ピルが表示されます。メニューバーのimux > アップデートを確認から手動で確認することもできます。

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

セッション復元（現在の動作）

再起動後、imuxはレイアウトとメタデータのみを復元します：

ウィンドウ、ワークスペース、ペインのレイアウト
作業ディレクトリ
ターミナルのスクロールバック（ベストエフォート）
ブラウザのURLとナビゲーション履歴

imuxはライブプロセスの状態はまだ復元しません。Claude Code、tmux、vimなどのアクティブなターミナルアプリセッションは、アプリの再起動後に再開されません。

動作要件

macOS 14.0以降
Apple SiliconまたはIntel Mac