프로젝트 소개

opencode-pty는 OpenCode용 플러그인으로, 대화형 의사 터미널(PTY) 관리를 제공합니다. 이를 통해 AI 에이전트는 백그라운드 프로세스를 실행하고, 대화형 입력을 보내며, 필요할 때 출력을 읽을 수 있어 OpenCode의 내장 동기식 bash 도구의 한계를 극복합니다. 주요 기능은 다음과 같습니다: - 장기 실행 프로세스(개발 서버, 감시 모드, 대화형 프로그램)의 백그라운드 실행 - 여러 개의 동시 PTY 세션 - 이스케이프 시퀀스(예: Ctrl+C)를 사용한 대화형 입력 - 페이지네이션 및 정규식 필터링을 포함한 출력 버퍼링 - 폴링을 없애기 위한 종료 알림 - OpenCode의 bash 권한 설정 준수 - 자동 정리를 포함한 세션 수명 주기 관리 - WebSocket을 통한 실시간 스트리밍을 제공하는 React 기반 웹 UI - 세션 관리를 위한 REST API 설정은 간단합니다: OpenCode 구성에 "opencode-pty"를 추가하세요. V2의 경우 "opencode-pty/v2"를 사용하며, 포트 및 호스트 이름과 같은 선택적 옵션을 지정할 수 있습니다. 이 플러그인은 pty_spawn, pty_write, pty_read, pty_list, pty_kill 도구와 웹 UI를 여는 슬래시 명령을 제공합니다. 웹 UI는 세션 목록, 실시간 출력, 입력 전송, 세션 관리를 제공합니다. 구성에는 버퍼 크기와 웹 서버 설정을 위한 환경 변수가 포함됩니다. 권한은 OpenCode의 bash 권한 구성에 따라 확인되며, "ask" 권한에는 제한이 있습니다. README에는 사용 예시, 세션 수명 주기 다이어그램, 개발 지침이 포함되어 있습니다.