AI 코딩 에이전트 세션 기록을 한 곳에서 검색하고 비용을 추적하는 방법
여러 AI 코딩 도구를 동시에 쓰다 보면, 어떤 세션에서 어떤 토큰을 썼는지, 어떤 파일이 바뀌었는지 추적하기가 어려워집니다. agentsview는 로컬에 저장된 세션 데이터를 수집해 웹 인터페이스에서 검색하고 분석할 수 있게 해 줍니다. 최신 버전 0.46.1에서는 Antigravity 전사 기록과 읽기 전용 마운트 문제를 수정하고, 반복된 프롬프트를 보존하며 컨테이너 빌드를 복구했습니다.
로컬 데이터 기반의 통합 아카이브
agentsview는 사용자의 머신에 있는 AI 에이전트 세션 디렉터리를 자동으로 발견하고 로컬 SQLite 데이터베이스로 동기화합니다. 이 과정에서 세션 아카이브는 사용자가 특정 기능을 선택하지 않는 한 로컬에 그대로 유지됩니다. 서버는 웹 UI, API, 세션 동기화, 파일 워처를 하나의 프로세스로 처리하며, serve 명령으로 전경에서 실행하거나 daemon start로 백그라운드로 실행할 수 있습니다. 첫 실행 시 지원되는 모든 에이전트의 세션을 발견하고 웹 UI를 http://127.0.0.1:8080에서 제공합니다. SSH 포트 포워딩이나 리버스 프록시를 통해 접근할 때는 --public-url 플래그를 사용해 브라우저에서 여는 정확한 오리진을 지정해야 403 오류를 피할 수 있습니다.
50여 개 에이전트 지원 및 세션 탐색 기능
Claude Code, Codex, Cursor, Windsurf 등 50개 이상의 AI 코딩 에이전트 세션을 지원합니다. Aider는 중앙 세션 디렉터리가 없어 AIDER_DIR 환경 변수를 설정해야 하며, Amp는 현재 릴리스가 서버 측에 스레드를 저장할 수 있어 비추천 상태로 유지됩니다. 웹 UI에서는 전체 텍스트 검색, 의미론적 검색, 토큰 사용량 대시보드, 활동 히트맵, 도구 사용 빈도 등을 확인할 수 있습니다. 특히 'Recent Edits' 피드에서는 에이전트가 최근 변경한 파일들을 프로젝트와 경로별로 그룹화해 보여 주며, 각 항목은 해당 변경을 만든 메시지로 연결됩니다. 또한 8개 언어를 지원하고 SSE를 통해 활성 세션의 새 메시지를 실시간으로 업데이트합니다.
토큰 비용 추적 및 분석 리포트
agentsview usage 명령은 모든 코딩 에이전트의 토큰 소비량과 컴퓨트 비용을 추적합니다. LiteLLM과 OpenRouter의 요율을 자동으로 적용하며, 오프라인 폴백도 지원합니다. 프롬프트 캐싱을 고려한 비용 계산, 모델별 상세 분석, 날짜 및 에이전트 필터링 기능을 제공합니다. agentsview stats 명령은 세션 기간, 사용자 메시지 수, 피크 컨텍스트, 턴당 도구 수 등의 분포를 포함한 창 범위 분석을 출력합니다. Git 기반 결과 지표는 느리거나 불안정할 수 있어 --include-git-outcomes 플래그를 명시적으로 사용해야 활성화됩니다. 모든 리포트는 서버 실행 없이 독립적으로 실행 가능하며, JSON 출력으로 스크립팅에 활용할 수 있습니다.
설치 및 배포 방법
Windows는 PowerShell에서 irm https://agentsview.io/install.ps1 | iex를 실행하거나, GitHub Releases에서 데스크톱 앱을 다운로드합니다. Homebrew를 사용하는 경우 brew install --cask agentsview 명령도 지원합니다. PostgreSQL, DuckDB, Quack 등 다양한 데이터 소스와의 연동 예제가 포함되어 있으며, docker-compose.prod.yaml을 통해 프로덕션 환경 구성을 참고할 수 있습니다.
사용 전 확인 사항
Docker 배포 시 컨테이너에 마운트하지 않은 에이전트 세션 디렉터리는 UI에 표시되지 않으므로, 필요한 에이전트의 세션 경로를 명시적으로 마운트하고 환경 변수를 설정해야 합니다. Aider와 같은 중앙 저장소가 없는 에이전트는 디렉터리 스캔 범위를 제한적으로 설정해야 macOS의 프라이버시 프롬프트를 피할 수 있습니다. 또한 SSH를 통한 원격 접근 시 --public-url 설정이 없으면 API 요청이 거부되므로, 네트워크 구성에 맞는 플래그를 반드시 지정해야 합니다.