tui-tester

TUI テスタースキル

このスキルは、ターミナルの自動化を使用して Gemini CLI の動作変更と表示出力を検証するための運用マニュアルです。

主な責務

• 動作の検証：コード変更によって、期待どおりのターミナル操作が行われることを確認します。
• 表示の検証：さまざまなターミナルサイズや状態で、TUI が正しく描画されることを確認します。
• リグレッションテスト：自動化を利用して、既存の対話型ワークフローが壊れるのを防ぎます。

重要なプロトコル

TUI テストを実施する際は、以下の厳格なルールに従ってください。

1. 初期化

最初に必ず実行する操作は、次のとおりです。 agent-tui スキルを有効にします。これにより、ターミナルの自動化に必要な基盤ツールが提供されます。

2. 環境のセットアップ（macOS／並列実行に対応）

グローバルデーモンが起動しており、ライブプレビューが開いていることを確認します。

if ! agent-tui sessions >/dev/null 2>&1; then
  tmux kill-session -t agent-tui 2>/dev/null || true
  agent-tui daemon stop 2>/dev/null || true
  rm -f /tmp/agent-tui*
  tmux new-session -d -s agent-tui 'agent-tui daemon start --foreground > /tmp/agent-tui-daemon.log 2>&1'
  sleep 1
fi
agent-tui live start --open

3. セッション管理

• セッション ID：以降の操作では、常に agent-tui run が返す session_id を使用します。
• アトミックな実行：1 ターンにつき、コマンドを正確に 1 つ実行します。操作をパイプラインでつなげないでください。
• ループ：操作 → 待機 → スクリーンショット → 検証 → 次の操作

4. Gemini CLI 固有の注意事項

• 最初にビルド：ローカルの変更をテストする前に、必ず npm run build または npm run build:all を実行します。
• 信頼確認の回避：フォーカスを奪うモーダルを避けるため、GEMINI_CLI_TRUST_WORKSPACE=true を設定します。
• 設定の分離：個人設定との干渉を防ぐため、GEMINI_CLI_HOME を使用します。

ワークフローの例

# Start the CLI
env GEMINI_CLI_TRUST_WORKSPACE=true agent-tui run node packages/cli/dist/index.js

# Wait for the prompt
agent-tui wait "│" --assert

# Send a command
agent-tui type "/help"
agent-tui press Enter

# Verify output
agent-tui wait "Available Commands" --assert

エラーからの復旧

待機がタイムアウトした場合は、最新のスクリーンショットを撮影して状態を確認します。os error 61 が表示された場合は、tmux を使ってデーモンを再起動します。