概要
CLI Commentator は、ターミナル（CLI）の出力を別ウィンドウでリアルタイムに実況・解説するデスクトップアプリケーションです。CLIをPTYで包んで起動し、ログをイベント化して実況テキストを配信します。
Claude Code や Codex などのAIコーディングツールの動作を横で見ながら、何をしているのかを把握するような使い方に適しています。
主な機能
Managed Terminal
CLI を直接アプリ内で起動。bash / codex / claude 等をワンクリックで立ち上げ。
リアルタイム実況
CLI出力をイベント化し、右パネルで処理の意味を日本語で解説。
口調カスタマイズ
ずんだもん風・丁寧語など、実況の口調やスタイルを自由に設定。
読み上げ（TTS）
実況テキストを音声で読み上げ。作業しながら耳で状況を把握。
複数入力モード
PTY直接起動 / ログファイル監視 / Claude hook連携 / Codex連携に対応。
ログ検索・フィルタ
本文 / 詳細 / 種別でログを検索。カード表示で見やすく整理。
対応する入力モード
- PTY モード — CLI を直接アプリ内で起動して監視（デフォルト）
- File モード — 外部ログファイルを tail 監視
- Claude Code 連携 — Claude の hook 経由でログを取得し実況
- Codex 連携 — Codex のログディレクトリを監視して実況
技術スタック
- フロントエンド: Vite + React（Web UI）
- バックエンド: Node.js + WebSocket（ログ配信サーバー）
- デスクトップ: Tauri v2（Rust + Sidecar）
- PTY:
node-ptyによるターミナルエミュレーション
動作環境
- macOS（.dmg で配布）
- 開発時: Node.js 20+ / pnpm / Rust ツールチェーン