lookout は何をしますか？
iTerm2タブでClaude Codeの状態をひと目で把握 — 白=待機中、青=処理中、オレンジ=待機中。iTerm2デーモン + launchdウォッチドッグ + macOS通知 + 6つのコンパニオンスキル。macOS専用。
概要
lookoutはClaude Codeと連携してiTerm2タブの色を変更し、Claude Codeが現在アイドル状態か、処理中か、または入力を待機中かを視覚的に示します。macOS専用。
主な機能
- 状態表示: タブの色が状態を表します:
- 白 = アイドル（待機中）
- 青 = 処理中（Claude Codeが応答生成中）
- オレンジ = 待機中（Claude Codeがユーザー入力を待機中）
- macOS通知: 状態が変化すると通知センターに通知を送信します。
- launchdウォッチドッグ: デーモンがクラッシュした場合に自動的に再起動します。
- 6つのコンパニオンスキル: 様々な状況に応じた補助的なスキルが含まれています。
インストール
# リポジトリをクローン
cd ~/path/to/lookout
# iTerm2デーモンをインストール（launchd用のplistを設定）
./install.sh
# スキルをClaude Codeに読み込ませる
claude add-skill ./lookout-skill.md
注意: iTerm2がインストールされ、"Python API"が有効になっていることを確認してください（iTerm2 > Preferences > General > Magic > Enable Python API）。
使い方
ステータスを手動で設定するコマンド:
lookout idle # タブを白に設定
lookout processing # タブを青に設定
lookout waiting # タブをオレンジに設定
Claude Codeは自動的に状態を変更します。スキルが読み込まれると、Claude Codeは以下のように動作します:
- 応答を生成し始めるとタブを青に設定します。
- 応答が完了するとタブを白（アイドル）に戻します。
- ユーザーに確認を促す場合、タブをオレンジ（待機中）に設定します。
コンパニオンスキル
このリポジトリにはcompanions/ディレクトリ内に6つのコンパニオンスキルが含まれています:
lookout-notify— 状態変更時にmacOS通知を送信します。lookout-timer— 長時間の処理やアイドル状態を追跡します。lookout-persist— ターミナルセッション間で状態を維持します。lookout-summary— Claude Codeのセッションの簡単な概要を提供します。lookout-suggest— 現在の状態に基づいて次のアクションを提案します。lookout-alert— 長期間のアイドル状態や処理の滞留を警告します。
各スキルは個別に追加でき、追加の依存関係や設定は必要ありません。
アンインストール
./uninstall.sh # launchdサービスを削除
claude remove-skill lookout-skill.md
トラブルシューティング
- タブの色が変わらない: iTerm2でPython APIが有効になっているか確認してください。
- デーモンが起動しない:
~/.lookout/logのログファイルを確認してください。 - 状態が正しく表示されない:
lookout idleを実行して手動でリセットしてください。
ライセンス
MIT