mcpField
P
pty-capture

pty-capture

github.com/factory-aiテスト・品質11785 回インストール4 日前に更新
リポジトリ

pty-capture について

端末がキー入力に対して出力する正確なバイト列を記録するスキルです。画面表示ではなく入力エンコーディングの確認を目的とし、Linux、Windows、macOS の手順と CLI 互換性テストへの利用を説明します。

主な機能

  1. 01キー入力に対する出力バイトの記録
  2. 02Linux、Windows、macOS に対応
  3. 03プラットフォーム別の記録手順
  4. 04記録データをリプレイテストに利用

活用シーン

  1. 01端末が送るキーシーケンスの検証
  2. 02端末互換性テスト用フィクスチャの作成
  3. 03CLI のキー処理のデバッグ

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/factory-ai/factory-plugins --skill pty-capture

インストール後、Claude Code で/pty-captureを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

platforms/
linux.md
macos.md
windows.md

詳細

PTY バイトキャプチャ

オーケストレーターによってここに案内されました。以下の手順を使って計画を実行してください。

指定したキー入力に対して、実際のターミナルが出力するバイト列を正確にキャプチャします。「UI の表示は正しいか」ではなく、「ターミナル X はキー Y に対してどのシーケンスを送信するか」を確認する場合に使ってください。

プラットフォームのサポート

プラットフォーム状態参照先
Linux / Wayland実装済みplatforms/linux.md
Windows(KVM)実装済みplatforms/windows.md
macOS(QEMU)実装済みplatforms/macos.md

対象 OS のプラットフォームファイルを読んでください。 各ファイルには、キャプチャのアーキテクチャ、前提条件、使用方法、プラットフォーム固有の注意事項が記載されています。

既知の行き止まり

  • Xvfb + xdotool:実際のキーボード処理を完全に迂回します
  • uinput + Xvfb:Xvfb はカーネルの入力デバイスを認識しません
  • キー入力の注入に SSH PTY を使う方法:入力エンコーディングが変化します。SSH は出力のキャプチャまたはデプロイのみに使用してください

次の手順

キャプチャしたバイト列をターミナル互換性フィクスチャに渡し、apps/cli でリプレイテストを実行します。

コメント