marmonitor - tmux 상태바에서 AI 코딩 에이전트 세션을 실시간 추적

Context

tmux 내 다수 AI 코딩 에이전트 동시 실행 시 상태 확인을 위해 개별 pane을 일일이 전환해야 하는 번거로움 발생. 세션별 진행 단계와 상태를 한눈에 파악하기 어려운 구조적 한계 존재.

Technical Solution

• tmux 상태바를 활용하여 세션 수와 현재 phase(승인대기, 생각중, 실행중, 완료)를 실시간 표시하는 모니터링 체계 구축
• Option+1~5 단축키를 통해 특정 세션 pane으로 즉시 이동하는 빠른 네비게이션 기능 구현
• marmonitor status 명령어로 토큰 사용량, CPU, MEM, 프로세스 트리를 확인하는 상세 진단 인터페이스 제공
• 외부 API 키나 네트워크 통신 없이 로컬 프로세스 정보만 읽어오는 읽기 전용 관찰 방식 채택
• TypeScript 기반 설계와 npm 패키지 매니저를 통한 간편한 설치 및 설정 구조

Key Takeaway

복잡한 다중 세션 환경에서 컨텍스트 스위칭 비용을 최소화하기 위해 UI/UX 접점인 상태바를 활용한 가시성 확보 전략.