# TmuxAI - Tmux 안의 AI 페어 프로그래머

> Clean Markdown view of GeekNews topic #20665. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=20665](https://news.hada.io/topic?id=20665)
- GeekNews Markdown: [https://news.hada.io/topic/20665.md](https://news.hada.io/topic/20665.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2025-05-03T09:32:01+09:00
- Updated: 2025-05-03T09:32:01+09:00
- Original source: [github.com/alvinunreal](https://github.com/alvinunreal/tmuxai)
- Points: 4
- Comments: 1

## Topic Body

- tmux 세션 내에서 동작하는 **지능형 터미널 AI 도우미**로, **tmux 창의 모든 pane을 관찰**하며 사용자 입력 없이도 터미널의 컨텍스트를 읽고 명령을 제안하거나 실행할 수 있음  
- 기본적으로 OpenRouter 기반 AI 모델을 사용하지만, **OpenAI, Claude, 로컬 Ollama 등 다양한 LLM과도 호환**  
- **Observe / Prepare / Watch 모드**를 통해 사용자의 워크플로우를 방해하지 않으며, **실제 페어 프로그래머처럼 터미널을 관찰, 대화, 실행**  
  - Observe Mode: 모든 pane의 내용을 캡처하고, **사용자 질문에 따라 명령어 제안 및 실행 여부를 묻고 진행**하며, 명령 실행 후 일정 시간 기다린 뒤 다시 context 캡처 → AI 피드백 루프 반복  
  - Prepare Mode: 셸 프롬프트를 수정하여 **명령어 실행 완료를 정밀하게 추적**, 대기 시간 없이 실시간 피드백 가능. bash/zsh/fish 지원  
  - Watch Mode: 사용자의 작업을 **능동적으로 감시하고 더 나은 명령을 추천**  
- 하나의 창 안에서 다음과 같은 역할로 구성:  
  - **Chat Pane**: 사용자와 AI 간의 대화 인터페이스  
  - **Exec Pane**: AI가 명령어를 실행하는 전용 창  
  - **Read-Only Panes**: 나머지 pane의 내용은 읽기 전용으로 AI가 컨텍스트로 활용  
- 설치는 단 한 줄의 스크립트로 가능하며, Homebrew나 수동 설치도 지원  
- 컨텍스트가 길어지면 **이전 대화를 요약하여 압축(squash)**하는 기능을 통해 **LLM 토큰 비용과 한도를 효율적으로 관리**  
  - `/info`로 현재 사용량 확인, `/squash`로 수동 요약 가능

## Comments



### Comment 38137

- Author: bus710
- Created: 2025-05-03T13:24:19+09:00
- Points: 2

이젠 터미널에서 .env 파일 여는 것도 조심해야겠네요.