onesuper/tui-use

어떤 프로젝트인가요?

핵심 기능

• 01모든 프로그램을 PTY에서 실행하고 헤드리스 xterm 에뮬레이터로 출력을 렌더링합니다.
• 02화면 스냅샷을 일반 텍스트로 제공하며, JSON 형식도 선택할 수 있습니다.
• 03화면이 안정될 때까지 또는 특정 텍스트 패턴이 나타날 때까지 대기합니다.
• 04반전 표시된 영역을 알려 에이전트가 현재 선택 항목을 파악할 수 있게 합니다.
• 05백그라운드 데몬을 통해 CLI 호출 사이에도 세션을 유지합니다.
• 06화면에서 텍스트 입력, 붙여넣기, 특수 키 입력, 스크롤 및 정규식 검색을 지원합니다.

활용 사례

• 메모리 상태를 잃지 않고 장시간 실행되는 Python 세션을 디버깅합니다.
• 에이전트가 GDB 또는 pdb의 중단점과 변수를 확인하고 조작합니다.
• AI 코딩 에이전트가 vim이나 lazygit 같은 전체 화면 도구를 탐색하도록 합니다.
• 각 단계가 이전 출력에 따라 달라지는 대화형 REPL 세션을 실행합니다.

빠른 시작

1. 1

   npm에서 CLI 설치하기

   npm install -g tui-use
2. 2

   PTY 세션에서 프로그램 시작하기

   tui-use start python3 examples/ask.py
3. 3

   화면이 안정될 때까지 기다린 다음 응답을 입력하고 Enter 누르기

   tui-use wait
4. 4

   현재 화면 스냅샷 찍기

   tui-use snapshot

사용 전 알아둘 점

• !화면 출력에서 색상과 대부분의 텍스트 서식이 제거되며, 강조 표시, 제목, 전체 화면 상태만 유지됩니다.
• !Claude Code 또는 Codex 플러그인이 작동하려면 별도로 CLI를 설치해야 합니다.

토픽

자주 묻는 질문

tui-use은(는) 무엇인가요?

AI 에이전트가 PTY를 통해 REPL, 디버거, TUI 앱 같은 대화형 터미널 프로그램을 조작할 수 있는 CLI tui-use는 키보드 입력을 전제로 하는 프로그램을 AI 에이전트가 다룰 수 있게 해주는 명령줄 도구입니다. 의사 터미널 안에서 프로그램을 실행하고, 헤드리스 xterm 에뮬레이터로 출력을 렌더링한 다음, 현재 화면을 깔끔한 일반 텍스트로 제공합니다. 에이전트는 키 입력을 보내고 결과를 확인한 뒤 다음 동작을 결정할 수 있습니다.

tui-use은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

tui-use은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

tui-use은(는) 아직 유지보수되고 있나요?

6개월 이상 커밋 없음. tui-use의 마지막 커밋은 2026년 4월 11일입니다.

tui-use은(는) 어디에 사용할 수 있나요?

메모리 상태를 잃지 않고 장시간 실행되는 Python 세션을 디버깅합니다. 에이전트가 GDB 또는 pdb의 중단점과 변수를 확인하고 조작합니다. AI 코딩 에이전트가 vim이나 lazygit 같은 전체 화면 도구를 탐색하도록 합니다. 각 단계가 이전 출력에 따라 달라지는 대화형 REPL 세션을 실행합니다.

tui-use는 어떻게 설치하나요?

npm에서 CLI 설치하기: npm install -g tui-use PTY 세션에서 프로그램 시작하기: tui-use start python3 examples/ask.py 화면이 안정될 때까지 기다린 다음 응답을 입력하고 Enter 누르기: tui-use wait 현재 화면 스냅샷 찍기: tui-use snapshot

tui-use은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/onesuper/tui-use