macOS のメニューバーに常駐し、Colima とコンテナの状態を表示・操作する小さなアプリ。
- メニューバーアイコンで Colima の状態がひと目で分かる
- 実行中: 塗りつぶし / 停止中: アウトライン / 操作中: 丸付き
- 稼働中なのにポート公開すべきコンテナが落ちている場合はオレンジ色
- コンテナ一覧
- compose はプロジェクト単位でグループ化し、状態を●で色分け(緑: 稼働 / オレンジ: 一部停止 / グレー: 全停止)
- 各行に稼働状況(「4分前に起動」)・イメージ・ポート(
ホスト:コンテナ)を表示 - ポートなしの exited コンテナ(cli / init 系)はノイズになるので非表示
- Colima のバージョンと VM の割り当て(CPU/メモリ/ディスク)、コンテナごとの CPU/メモリ使用量(docker stats)
- ディスク使用量の内訳(イメージ / コンテナ / ボリューム / ビルドキャッシュ、
docker system df) - メニューを開いている間は 3 秒間隔でライブ更新
- Colima の起動・再起動・停止
- compose プロジェクトの起動(
up -d)・再起動・停止・破棄(down、確認あり) - コンテナ単体の起動・再起動・停止・破棄(
rm -f、確認あり) - 公開ポートをブラウザで開く(⌥ で URL コピーに切り替え)
- ターミナルで接続(
docker exec、bash/sh 自動判別)・ログ表示(docker logs -f) - compose プロジェクトをエディタで開く(Zed / VS Code / Cursor など、「設定」でインストール済みのエディタから選択)
- ディスクのお掃除(未使用イメージ / ビルドキャッシュ / 匿名ボリュームの削除、確認あり)
- ポート公開コンテナが勝手に停止 / unhealthy になったら macOS 通知 (自分の操作による変化と Colima 自体の起動停止は通知しない)
- スリープ復帰時に即リフレッシュ
- ログイン時に自動起動のトグル(.app バンドルで起動しているときのみ)
- Hako / Colima の新しいバージョンが公開されたらメニューに知らせを表示(1 日 1 回確認)
- macOS 14.4+
colima/docker(Homebrew でインストールされていること)
brew install --cask nemooon/tap/hako
xattr -dr com.apple.quarantine /Applications/Hako.appApple Developer ID 署名なしのため、macOS が quarantine 属性を付けて起動を
ブロックします。上の xattr で属性を外してから起動してください。
または、一度起動を試したあと「システム設定 → プライバシーとセキュリティ」の
セキュリティ欄で「このまま開く」を選びます。
swift run./scripts/bundle.sh
open dist # "Hako.app" をアプリケーションフォルダへログイン時の自動起動は、メニュー下部の「設定 > ログイン時に起動」から設定できます。
scripts/bundle.shのVERSIONを上げてコミット・push./scripts/release.sh <リリースノートのファイル>— ビルド → zip → GitHub リリースを作成 (ファイルを省略するとghがエディタを開きます)- リリース公開をトリガーに
.github/workflows/bump-cask.ymlが動き、 nemooon/homebrew-tap のCasks/hako.rbの version と sha256 を自動更新します
ワークフローには tap へ push できる PAT を TAP_GITHUB_TOKEN として
リポジトリシークレットに登録しておく必要があります。
docker compose downしたプロジェクトはコンテナが残っていないため一覧に出ません(stopなら出ます)- compose のポート情報は、停止中でも
docker inspectの設定値から補完しています
このアプリは Claude Code(Claude Fable 5)とのペアプログラミングで作られました。