libtmux-ts로 TypeScript에서 tmux를 제어한다

libtmux-ts 0.1은 Bun과 TypeScript에서 tmux 서버를 제어하는 라이브러리다. 서버 상태를 불변 스냅샷으로 읽고 타입이 지정된 데이터로 조회할 수 있으며, 기본 라이브러리는 런타임 의존성을 포함하지 않는다. GitHub 저장소

현재 API는 확정되지 않았다. 릴리스는 0.1.N 형식이며, 버전이 올라갈 때마다 N이 증가한다. 어느 릴리스에서든 내보내는 식별자가 바뀌거나 제거될 수 있고, 변경 사항은 변경 기록에 표시된다. 업그레이드 전에 변경 기록을 확인하고, 변경을 피하려면 정확한 버전을 고정해야 한다.

이 라이브러리는 프로그램에서 tmux를 제어하려는 경우에 적합하다. 명령을 실행하고 출력 결과를 읽는 에이전트, 작업 공간 실행기, 테스트 도구, 대시보드 등이 대상이다. .tmux.conf 생성기나 TUI는 아니며, 실행 중인 서버를 제어한다.

Bun 1.3.14 이상 또는 Node 22 이상, tmux 3.3a 이상이 필요하다. 확인하는 tmux 버전은 클라이언트가 아니라 실행 중인 데몬의 버전이다. 기준보다 오래된 데몬이나 이를 시작할 실행 파일은 명령이 적용되기 전에 VersionTooLowError로 거부된다. Linux와 WSL에서 실행되며, macOS는 지원하지만 관련 CI 테스트 범위는 매우 제한적이다.

libtmux 외에도 AI 에이전트가 tmux 세션과 창을 다루도록 하는 @libtmux/mcp, 선언형 작업 공간을 만드는 @libtmux/workspace, tmuxp 작업 공간 파일을 불러오고 변환하는 @libtmux/workspace-cli가 포함된다. 네 패키지는 릴리스 버전을 공유한다. MCP 서버는 세션 조회, 패널 출력 읽기, 키 입력, 출력 대기 등의 도구를 제공한다.

라이브러리는 tmux 3.3a부터 3.8까지 실제 tmux 서버를 대상으로 테스트한다고 설명한다. Python용 libtmux 0.62.0을 참고해 이름과 구조를 맞췄으며, TypeScript와 맞지 않는 부분은 별도로 결정했다고 밝혔다. 자세한 설치·사용법은 저장소 문서와 API 참조에서 확인할 수 있다.