このプロジェクトについて

opencode-ptyは、OpenCodeに対話型疑似端末(PTY)管理を提供するプラグインです。AIエージェントがバックグラウンドプロセスを実行し、対話型入力を行い、必要に応じて出力を読み取ることを可能にし、OpenCode内蔵の同期bashツールの制限を克服します。 主な機能は次のとおりです。 - 長時間実行プロセス(開発サーバー、watchモード、対話型プログラム)のバックグラウンド実行 - 複数の同時PTYセッション - エスケープシーケンス(例: Ctrl+C)による対話型入力 - ページネーションと正規表現フィルタリングを備えた出力バッファリング - ポーリングを不要にする終了通知 - OpenCodeのbash権限設定の尊重 - 自動クリーンアップを伴うセッションライフサイクル管理 - WebSocketによるリアルタイムストリーミングを備えたReactベースのWeb UI - セッション管理用のREST API セットアップは簡単です。OpenCodeの設定に「opencode-pty」を追加します。V2では「opencode-pty/v2」を使用し、portやhostnameなどの任意オプションを指定できます。 このプラグインは、pty_spawn、pty_write、pty_read、pty_list、pty_killというツールと、Web UIを開くためのスラッシュコマンドを提供します。Web UIでは、セッション一覧、ライブ出力、入力送信、セッション管理を利用できます。 設定には、バッファサイズとWebサーバー設定用の環境変数が含まれます。権限はOpenCodeのbash権限設定に対して確認され、「ask」権限には制限があります。 READMEには、使用例、セッションライフサイクル図、開発手順が含まれています。