tmux AI 에이전트 감시탑 — OnePageDaily

Zero Instrumentation

터미널 상태바가
AI 에이전트 관제탑이 된다

Claude · Codex · Gemini 동시 세션을 tmux 한 줄로 추적

12개의 Claude 세션 중 어느 pane이 승인을 기다리는지 모른 채 몇 분을 허비한 적 있다면, marmonitor가 그 문제를 직접 겨냥했다. 외부 API 없이 로컬 프로세스만 읽어 상태바에 에이전트 카운트·phase 알림·주의 pill을 실시간으로 표시한다.

3종

지원 에이전트 (Claude/Codex/Gemini)

2초

데몬 스캔 주기

0개

외부 API 의존성

7일

활동 로그 보존 기간

▼ SCROLL

작동 방식

Status Bar

한눈에 보이는 카운트

Cl 12 · Cx 2 · Gm 1

에이전트별 활성 세션 수를 약어로 압축해 상태바에 표시
⏳ permission · 🤔 thinking · 🔧 tool phase 아이콘 실시간 갱신
주의 필요 pane 번호 pill로 즉시 인식 가능

Binding Pipeline

프로세스-파일 바인딩의 핵심

PID → 세션 파일 6단계 파이프라인

PID → Identity Resolver → File Binding → Reconciliation 순서로 처리
Binding Cache + Binding History로 stale PID 문제 해결
Claude /clear 후 새 UUID·JSONL 생성 시에도 자동 재바인딩

Zero Instrumentation

에이전트를 건드리지 않는다

Read-only · No network · No plugin

에이전트 코드·설정 수정 없이 로컬 파일만 read-only로 읽음
외부 API 호출·네트워크 트래픽 전무
기존 워크플로에 투명하게 삽입

Jump

주의 필요 pane 즉시 이동

Option+1~5 단축키 점프

permission 승인 대기 pane을 번호 pill로 상태바에 표시
Option+숫자로 해당 tmux pane 직접 이동
marmonitor jump-back으로 이전 pane 즉시 복귀

Agent Support

에이전트별 바인딩 전략이 다르다

Claude · Codex · Gemini 각각 다른 방식

Claude: ~/.claude/sessions/{pid}.json → sessionId → JSONL direct/provisional
Codex: cwd + processStartedAt을 SQLite thread index와 매칭, TTL registry
Gemini: cwd → ~/.gemini/tmp project dir 최신 session-*.json 추적

CLI

설치 한 줄, 명령 다섯

npm install -g marmonitor

marmonitor setup tmux으로 플러그인·상태바 자동 설정
status / attention / activity / watch / jump-back 서브커맨드 제공
활동 로그 ~/.config/marmonitor/activity-log/ 7일 보존

기존 방식과 비교

쟁점	marmonitor	수동 확인
permission 승인 대기 감지	상태바 pill 즉시 표시	각 pane 수동 이동·확인
에이전트 코드 수정 필요	없음 (read-only)	없음
세션 수 실시간 파악	상태바 카운트 2초 갱신	pane 일일이 이동
Claude /clear 후 세션 추적	PID 유지, 자동 재바인딩	추적 단절

이런 상황에 쓴다

⏳

승인 대기 감지

Permission Alert

🤔

thinking 상태 파악

Phase Monitor

🔧

tool 실행 추적

Tool Phase

📊

에이전트별 세션 카운트

Agent Count

🎯

주의 pane 즉시 이동

Quick Jump

🔄

이전 pane 복귀

Jump Back

📋

활동 로그 조회

Activity Log

🕵️

세션-프로세스 바인딩

Binding Pipeline

AI 코딩 에이전트를 동시에 열 개 이상 돌리면 공통 문제가 생긴다. 어느 pane이 permission 승인을 기다리는지 알 방법이 없어서 에이전트가 수분간 멈춰 있어도 모른다. marmonitor는 tmux 상태바 한 줄에 'Cl 12 · Cx 2 · Gm 1' 형태로 에이전트 수와 현재 phase를 표시해 이 문제를 직접 겨냥한다.

핵심 설계 원칙은 zero instrumentation이다. 에이전트 코드나 설정을 건드리지 않고, 외부 API 호출도 없이, OS 로컬 프로세스와 세션 파일만 read-only로 읽는다. npm install -g marmonitor와 marmonitor setup tmux 두 줄로 기존 워크플로에 투명하게 삽입된다.

가장 까다로운 기술 문제는 파일 파싱이 아니라 살아있는 OS 프로세스를 올바른 세션 파일에 바인딩하는 것이다. Claude에서 /clear를 실행하면 PID는 유지된 채 새 session UUID와 JSONL이 생성된다. marmonitor는 PID → Identity Resolver → File Binding → Reconciliation → Binding Cache → Binding History 6단계 파이프라인으로 이 stale PID 문제를 처리한다.

주의 필요 pane은 번호 pill로 상태바에 표시되고, Option+1~5 단축키로 해당 pane에 즉시 이동한다. 작업 후 marmonitor jump-back으로 이전 pane에 복귀할 수 있다. 데몬은 2초마다 스캔하며 활동 로그를 7일간 ~/.config/marmonitor/activity-log/에 보존한다.

현재 macOS 우선 지원이며 Linux는 미테스트 상태다. Gemini permission 감지는 제한적이고 phase 감지는 heuristic이라는 점이 명시된 한계다. v0.2.5, Node ≥18, MIT 라이선스로 공개되어 있다.

AI 에이전트 시대의
새 관제 인터페이스

tmux 상태바 한 줄이 수십 개 AI 세션의 실시간 관제탑이 된다. marmonitor는 그 인터페이스를 최소 침습으로 구현했다.

원문 보기 · mjjo16/marmonitor · GitHub · v0.2.5 · MIT

터미널 상태바가AI 에이전트 관제탑이 된다

작동 방식

기존 방식과 비교

이런 상황에 쓴다

AI 에이전트 시대의새 관제 인터페이스

터미널 상태바가
AI 에이전트 관제탑이 된다

AI 에이전트 시대의
새 관제 인터페이스

marmonitor — tmux 상태바가 된 AI 에이전트 관제탑

Reference Links

Comments (0)