VladislavTsytrikov/tmuxpad

tmuxpad은(는) 무엇을 하나요?

AI 코딩 에이전트를 위한 tmux 미션 컨트롤 — KDE Plasma 6 위젯으로 Claude Code, aider, codex 에이전트의 작업 상태(진행 중, 입력 대기, 유휴)를 표시하고, 데스크톱 알림 및 원 키 빠른 응답을 제공합니다.

개요

VladislavTsytrikov/tmuxpad는 KDE Plasma 6 데스크톱 환경에서 실행되는 위젯으로, tmux 세션 내에서 동작하는 여러 AI 코딩 에이전트의 상태를 실시간으로 모니터링합니다. 각 에이전트가 현재 작업 중인지, 사용자 입력을 기다리고 있는지, 또는 유휴 상태인지 시각적으로 표시하며, 입력 대기 상태일 때는 데스크톱 알림을 보냅니다. 또한 단축키 하나로 바로 응답을 입력할 수 있는 빠른 응답 기능을 제공합니다.

지원 플랫폼

• KDE Plasma 6 (위젯 실행 환경)
• tmux (터미널 멀티플렉서)
• AI 에이전트: Claude Code, aider, codex

설치

1. KDE Plasma 6 위젯으로 설치합니다:

   git clone https://github.com/VladislavTsytrikov/tmuxpad.git
   cd tmuxpad
   plasmapkg2 --install .
   

2. 위젯을 패널이나 데스크톱에 추가합니다:

   • KDE Plasma 데스크톱에서 마우스 오른쪽 버튼을 클릭합니다.
   • "위젯 추가"를 선택합니다.
   • "tmuxpad"를 검색하여 추가합니다.

설정

위젯 설정에서 다음 항목을 구성할 수 있습니다:

• tmux 소켓 경로: 기본값은 /tmp/tmux-1000/default입니다.
• 모니터링할 창 이름 패턴: Claude Code, aider, codex의 창 이름 패턴을 지정합니다.
• 알림 활성화: 입력 대기 상태일 때 데스크톱 알림을 보낼지 여부를 설정합니다.
• 빠른 응답 단축키: 원 키 빠른 응답에 사용할 단축키를 설정합니다.

사용법

1. tmux 세션에서 AI 코딩 에이전트를 실행합니다:

   tmux new-session -s claude-code 'claude'
   

2. 위젯이 자동으로 각 창의 상태를 감지하여 표시합니다:

   • 🟢 작업 중: 에이전트가 명령을 실행 중입니다.
   • 🟡 입력 대기: 에이전트가 사용자 입력을 기다리고 있습니다.
   • ⚪ 유휴: 에이전트가 대기 중입니다.

3. 입력 대기 상태일 때 데스크톱 알림이 표시됩니다.

4. 설정한 단축키를 눌러 바로 응답을 입력할 수 있습니다.

라이선스

MIT

기여

버그 리포트, 기능 제안, 풀 리퀘스트는 GitHub 저장소를 통해 환영합니다.