여러 AI 코딩 에이전트의 세션과 비용을 로컬에서 모아 보는 오픈소스 '에이전트뷰'

여러 AI 코딩 에이전트의 작업 세션을 한곳에서 둘러보고 검색하며 비용까지 추적해 주는 오픈소스 도구 '에이전트뷰(agentsview)'가 깃허브 트렌딩에 올랐다. 단일 실행 파일 하나로 동작하고 별도 계정이 필요 없으며, 모든 데이터를 사용자 컴퓨터 안에만 보관하는 로컬 우선 방식이 특징이다.

처음 실행하면 에이전트뷰가 컴퓨터에 설치된 모든 지원 에이전트의 세션을 찾아 로컬 SQLite 데이터베이스로 동기화한 뒤, 127.0.0.1:8080 주소에 웹 UI를 띄운다. 현재 클로드 코드, 코덱스, 포지(Forge), 오픈코드(OpenCode)의 세션을 인식한다. 'agentsview serve' 명령으로 서버와 웹 UI를 함께 실행한다.

설치 방법은 다양하다. macOS·리눅스용 셸 스크립트와 윈도우용 파워셸 스크립트, macOS·윈도우 데스크톱 앱, 홈브루 캐스크(brew install --cask agentsview), 그리고 공개된 도커 이미지를 통해 받을 수 있다. 저장소는 SQLite 기본값 외에 PostgreSQL 백엔드, DuckDB 미러, 쿼크(Quack) 엔드포인트로 구동하는 예시도 함께 제공한다.

'agentsview usage' 명령은 ccusage 같은 기존 도구를 대체하는 빠른 로컬 사용량 분석기다. 클로드 코드뿐 아니라 모든 코딩 에이전트의 토큰 소비량과 연산 비용을 추적하며, 세션 데이터가 이미 SQLite에 색인돼 있어 실행할 때마다 원본 세션 파일을 다시 파싱하는 도구보다 100배 이상 빠르다고 설명한다.

사용량 분석에는 라이트LLM(LiteLLM) 요율을 이용한 자동 가격 계산(오프라인 대비책 포함), 프롬프트 캐싱을 반영한 비용 산정, 모델별 분해(--breakdown), 날짜·에이전트 필터, JSON 출력, 시간대 인식 집계 기능이 들어간다. 서버 없이 명령만으로도 단독 실행된다.

'agentsview session usage <id>'는 특정 세션의 토큰 통계와 비용 추정치를 출력한다. 세션의 총 출력 토큰과 최대 컨텍스트 토큰, 그리고 가격 정보가 있을 때의 비용(cost_usd)을 함께 보고한다. 같은 데이터는 REST API의 'GET /api/v1/sessions/{id}/usage'로도 받을 수 있으며, 과거 명칭인 token-use 별칭도 호환을 위해 남아 있다.

'agentsview stats' 명령은 기록된 세션 전체에 대한 분석을 내놓는다. 합계, 세션 유형(자동화·짧음·표준·심층·마라톤) 분류, 세션 길이·사용자 메시지 수·최대 컨텍스트·턴당 도구 수 분포, 캐시 경제성, 도구·모델·에이전트 구성, 시간대별 분포를 담으며, JSON 출력은 버전이 매겨진 v1 스키마를 따른다. 커밋·변경 라인 수 같은 깃 기반 지표는 느려질 수 있어 옵션으로만 켤 수 있다.

웹 UI는 대시보드와 세션 뷰어, 전체 메시지 내용을 대상으로 한 전문 검색(FTS5), 활동 히트맵을 제공한다. 세션·모델별 비용 분해와 일별 지출 차트를 보여 주는 비용 대시보드, 도구 사용량·속도 지표·프로젝트별 분석을 담은 분석 대시보드도 있으며, 활성 세션에 새 메시지가 들어오면 실시간으로 갱신된다.

보안 측면에서 에이전트뷰는 루프백 주소에만 바인딩하고 요청의 호스트 헤더를 검증해 DNS 리바인딩 공격을 막는다. SSH 포트 포워딩이나 원격 개발 환경에서 접근할 때는 --public-url로 실제 접속 주소를 지정해야 하며, 루프백 밖으로 노출할 때는 --require-auth로 인증을 켜도록 안내한다.