AgentsView — 여러 AI 코딩 에이전트의 세션 검색·분석·비용 추적 도구

> 한 화면에서 Claude Code, Codex, Cursor, Gemini CLI, OpenCode의 세션을 모아 보고, 토큰 비용까지 한 번에 추적할 수 있는 로컬 도구를 소개합니다.

문제: 에이전트가 늘수록 흩어지는 "진짜 작업 기록"

AI 코딩 에이전트를 하나만 쓰는 시대는 지났습니다. 한 사람이 Claude Code로 백엔드를, Codex로 리팩터를, Cursor로 IDE 단위 편집을, Gemini CLI로 멀티모달 작업을, OpenCode로 경량 스크립트를 돌리는 일이 흔해졌습니다. 그런데 각 에이전트는 각자의 세션 디렉터리와 로그 포맷을 가지고 있어서, 다음 질문에 답하려면 도구를 다섯 개 뒤져야 합니다.

• "어제 이 버그를 고친 에이전트가 누구였지?"
• "이번 달 모델별 토큰 비용이 얼마야?"
• "어떤 프로젝트의 어떤 파일을 누가 언제 손댔어?"
• "이 세션이 표준 작업인지, 장시간 작업인지 분류할 수 있을까?"

이걸 로컬에서 한 번에 묶어주는 도구가 AgentsView입니다.

AgentsView란

AgentsView는 여러 코딩 에이전트의 세션 파일을 자동으로 수집해 SQLite에 색인하고, 로컬 웹 UI와 CLI로 검색·분석·비용 추적을 제공하는 도구입니다.

핵심 특징:

• Go 단일 바이너리로 실행 (Python 의존성 없음)
• 첫 시작 시 로컬 세션 파일을 자동으로 찾아 SQLite에 색인
• 127.0.0.1:8080에서 대시보드 제공
• CLI 명령: agentsview usage daily, agentsview session usage 등

1. 통합 세션 검색 — 빠르고 정확하게

SQLite FTS5를 기본으로 한 전문 검색이 내장되어 있습니다. OpenAI 호환 임베딩을 연결하면 의미 검색과 하이브리드 검색까지 활성화됩니다. 모든 세션을 한 인덱스에서 뒤지므로, "에이전트 X가 Y 에러를 만난 세션" 같은 교차 질의도 한 번에 끝납니다.

2. 토큰·비용 추적 — LiteLLM 가격표 기반

에이전트/날짜/모델별 사용량을 집계하고, LiteLLM 가격표와 프롬프트 캐시 생성/읽기 토큰까지 반영해 비용을 계산합니다.

• agentsview usage daily: 일별 전체 사용량
• agentsview session usage : 개별 세션 비용

특히 캐시 효율(캐시 히트 vs 미스)을 분리해서 보여주기 때문에, "프롬프트를 어떻게 설계해야 비용이 줄어드는가"를 데이터로 판단할 수 있습니다.

3. 작업 유형 자동 분류

세션을 다음 5개 카테고리로 자동 분류합니다:

1. 자동화 (Automation)
2. 짧은 작업 (Short Task)
3. 표준 (Standard)
4. 깊은 작업 (Deep Work)
5. 장시간 작업 (Long Run)

각 분류별로 세션 시간, 메시지 수, 최대 컨텍스트, 턴당 도구 사용량, 캐시 효율이 함께 제공됩니다. 단순 비교가 아니라 "어떤 종류의 작업이 어느 자원을 많이 먹는지" 패턴이 보이기 시작합니다.

4. Recent Edits — 파일 단위 변경 추적

여러 에이전트가 최근 수정한 파일을 프로젝트와 경로별로 묶어서 보여주고, 실제 변경을 만든 대화 메시지까지 역추적합니다. "이 함수 누가 마지막으로 손댔어?"라는 질문에 git blame보다 정확한 답을 줍니다 — 메시지 컨텍스트까지 함께 보이기 때문입니다.

5. 실시간 대시보드 — SSE 기반

진행 중인 세션을 Server-Sent Events로 받아서 대시보드에 실시간 표시합니다. 모델이 응답하는 동안 토큰이 누적되는 모습, 도구 호출이 일어나는 순간을 그대로 볼 수 있어, 디버깅과 데모 양쪽에 유용합니다.

6. 성능 — "이미 색인된 SQLite"의 위력

AgentsView는 색인된 SQLite를 조회하므로, 원본 세션을 매번 파싱하는 방식보다 100배 이상 빠릅니다. 색인은 첫 실행 시 한 번만 돌고, 이후로는 증분 갱신됩니다.

어떤 사람에게 유한가

• 에이전트 2개 이상을 동시에 쓰는 개발자 — 비용이 어디로 새는지 매달 추적하고 싶을 때
• 팀 리드 — 멤버별/프로젝트별 AI 사용 패턴을 정량적으로 보고 싶을 때
• 컨설팅/프리랜서 — 클라이언트별 AI 비용을 청구 근거로 만들 때
• 에이전트 개발자 — 자신의 도구가 실제로 어떻게 쓰이는지 사용자 동의 하에 관찰하고 싶을 때

설치와 시작

# Go 설치 후
go install github.com/kenn-io/agentsview@latest
agentsview
# 브라우저에서 http://127.0.0.1:8080 접속

첫 실행 시 로컬의 Claude Code/Codex/Cursor/Gemini CLI/OpenCode 세션 디렉터리를 자동으로 찾아 색인합니다. 추가 설정 없이도 즉시 대시보드가 뜹니다.

정리

AI 코딩 에이전트가 많아질수록 "도구 사용 기록" 자체가 1급 데이터가 됩니다. AgentsView는 그 데이터를 한 곳에 모아 비용·패턴·변경 이력을 모두 추적할 수 있게 해주는, 실용적인 로컬-first 옵저버입니다. 클라우드로 세션을 보내지 않는다는 점도 큰 장점입니다.

• --

• 원문*: AgentsView - 여러 AI 코딩 에이전트의 세션 검색/분석/비용 추적 도구

---

📰 원본 출처 · https://news.hada.io/topic?id=31370 (#N=31370)

이 글은 GeekNews(긱뉴스)에 게제된 글을 기반으로 작성되었습니다. 원본의 라이선스와 저작권은 원작자에게 있습니다.