AI 코딩 에이전트 로그, 실시간 관제 도구 등장

여러 AI 코딩 에이전트를 동시에 돌리기 시작하면 곧 벽에 부딪힌다. 지금 어떤 에이전트가 무슨 작업을 하고 있고 어디서 멈췄는지, 터미널에 쏟아지는 원시 로그만으로는 도무지 파악할 수가 없다. 개발자 라탄드(Latand)가 오픈소스로 공개한 라이브 로그 뷰어(Live Log Viewer)는 바로 이 지점을 파고든다. 클로드 코드(Claude Code)와 코덱스(Codex)가 남기는 원시 로그를 사람이 읽을 수 있는 실시간 채팅 화면으로 바꿔주는 로컬 도구다.

무슨 일인가

이 도구의 핵심 설계 원칙은 '전부 로컬'이다. 별도의 데이터베이스도, 외부 클라우드 서비스도 쓰지 않는다. 사용자 PC에 이미 쌓여 있는 로그 폴더(~/.claude, ~/.codex)를 직접 읽어 화면에 뿌릴 뿐이다. 실행 중인 모든 세션과 그 아래 딸린 서브에이전트, 코덱스 컴패니언 작업, 백그라운드 셸 작업을 스스로 찾아내 부모-자식 관계로 엮은 뒤, 선택한 항목을 실시간으로 따라간다. 데이터가 기기 밖으로 나가지 않으므로 보안에 민감한 1인기업도 부담 없이 붙여 쓸 수 있다.

핵심 짚어보기

겉보기엔 단순한 뷰어지만 내부 구조는 제법 촘촘하다.

• 클로드 코드 세션과 서브에이전트를 사용자 말풍선, 어시스턴트 서술, 도구 호출 카드(성공·실패를 ✓/✗로 표시하고 출력은 펼쳐 보기)로 채팅처럼 렌더링한다.
• 세션 → 서브에이전트 → 코덱스 작업 → 롤아웃 → 백그라운드 작업으로 이어지는 계보 트리를 서버 쪽에서 전사본을 훑어 만든다. 증분 방식에 캐시가 걸려 있어 반복 조회는 100밀리초 안팎으로 빠르다.
• 전사본 내용을 근거로 '작업 중'과 '완료' 배지가 자동으로 바뀌고, 모든 선택 상태가 주소(URL)에 반영돼 링크 하나로 같은 로그를 그대로 열 수 있다.
• npm에 배포돼 있어 설치가 간단하다. 저장소를 내려받을 필요 없이 bunx agent-log-viewer 한 줄이면 뜬다.

1인기업 실전 적용 포인트

• 여러 에이전트를 병렬로 굴리는 자동화 파이프라인이라면, 이 뷰어를 띄워 두고 각 에이전트의 도구 호출 성공·실패를 눈으로 감시하라. 실패 카드(✗)만 훑어도 어디서 파이프라인이 깨졌는지 몇 초 만에 잡아낸다.
• 딥링크 기능으로 문제가 생긴 세션 URL을 그대로 팀원이나 외주에게 넘기면, 로그 파일을 첨부하는 수고 없이 같은 화면을 바로 재현할 수 있다.
• 크론(cron)으로 밤새 돌린 에이전트 작업을 아침에 채팅 로그로 복기하면, 어떤 프롬프트에서 토큰을 낭비했는지 짚어내 비용을 줄일 수 있다.
• 클론·빌드 과정이 없으니 새 노트북이나 서버에서도 명령 한 줄로 즉시 관제 환경을 띄운다.

전망 / 주의점

아직 별점 수가 많지 않은 초기 프로젝트이고, 클로드 코드와 코덱스의 로그 형식에 맞춰져 있어 다른 에이전트 도구에는 곧바로 쓰기 어렵다. 다만 '에이전트 관제(observability)'라는 수요 자체는 분명하다. 에이전트를 하나만 돌리던 시절이 지나고 여러 대를 동시에 부리는 시대로 넘어가면서, 결과물만큼이나 '과정을 들여다보는 도구'가 실전 생산성을 좌우하는 변수로 떠오르고 있다.

출처: 해커뉴스 Show HN (https://github.com/Latand/live-log-viewer-next)