agentsview: 모든 AI 코딩 에이전트의 세션을 로컬에서 검색하고 분석하는 도구

읽을거리&정보공유
, , , , , , ,
1

agentsview: 모든 AI 코딩 에이전트의 세션을 로컬에서 검색·분석하는 도구
agentsview: 모든 AI 코딩 에이전트의 세션을 로컬에서 검색·분석하는 도구1536×1024 234 KB

agentsview 소개

요즘은 한 명의 개발자가 Claude Code, Codex, Cursor, Gemini CLI 등 여러 코딩 에이전트를 번갈아 씁니다. 그런데 각 에이전트는 세션 기록을 제각기 다른 디렉토리에 흩어 놓기 때문에, "지난주에 어떤 대화에서 이 코드를 고쳤더라", "이번 달 토큰 비용이 얼마였지" 같은 질문에 답하기가 어렵습니다. agentsview는 이렇게 흩어진 코딩 에이전트 세션을 한곳에 모아 검색·분석·비용 추적을 제공하는 도구입니다.

agentsview의 핵심 원칙은 "로컬 우선(local-first)"입니다. 계정 가입이 필요 없고, 단일 바이너리 하나로 동작하며, 모든 데이터는 사용자 머신에 남습니다. 첫 실행 시 agentsview는 머신에 있는 지원 에이전트들의 세션을 찾아내 로컬 SQLite 데이터베이스로 동기화하고, http://127.0.0.1:8080에서 웹 UI를 띄웁니다. 세션 데이터가 이미 SQLite에 색인되어 있기 때문에, 실행할 때마다 원본 세션 파일을 다시 파싱하는 도구보다 질의가 훨씬 빠릅니다.

agentsview는 전문 검색(full-text search), 토큰 사용량·비용 대시보드, 활동 분석, 최근 편집 피드 같은 기능을 하나의 웹 UI로 제공합니다. Go로 작성되어 macOS·Linux·Windows에서 단일 바이너리 또는 데스크톱 앱으로 실행할 수 있으며, 서버 없이 CLI 명령만으로도 사용할 수 있습니다. 본 게시물에서는 agentsview의 동작 방식, 주요 기능, 비용 추적, 설치 방법, 그리고 지원하는 코딩 에이전트 목록을 정리합니다.

agentsview의 동작 방식

agentsview의 분석 대시보드 화면
agentsview의 분석 대시보드 화면1440×900 122 KB

agentsview는 지원 에이전트들의 세션 디렉토리를 읽어 로컬 SQLite 아카이브로 동기화한 뒤, 웹 UI와 CLI로 그 데이터를 보여줍니다. 데스크톱 앱과 신선도가 중요한 CLI 명령은 분리된 로컬 데몬을 공유하는데, 읽기 전용 명령은 데몬이 떠 있으면 거기에 붙고 없으면 SQLite를 직접 읽어 일회성 스크립트도 빠르게 동작합니다. sync, usage처럼 최신 데이터가 필요하거나 쓰기가 필요한 명령은 데몬을 자동으로 시작합니다.

기본 저장소는 SQLite이지만, 여러 머신이 세션을 S3 호환 객체 스토리지로 밀어 넣고 중앙 인스턴스가 이를 읽도록 s3:// 루트를 설정할 수 있습니다. 이때 변경 감지는 크기·수정 시각과 ETag·버전 ID 같은 객체 지문을 활용해 바뀐 세션만 내려받습니다. 이 밖에 PostgreSQL 백엔드와 DuckDB 미러도 지원합니다.

AgentsView 구조: agent sessions sync into SQLite with FTS5 search, served via REST API, SSE events, and embedded Svelte SPA

보안 측면에서 agentsview는 루프백(loopback)에만 바인딩하고 요청의 Host 헤더를 검증해 DNS 리바인딩 공격을 막습니다. SSH 포트 포워딩이나 리버스 프록시로 접근할 때는 --public-url로 실제 브라우저 접속 주소를 지정하고, 루프백을 넘어 노출할 때는 --require-auth로 인증을 켜도록 안내합니다.

agentsview의 주요 기능

agentsview의 웹 UI는 세션 브라우저를 중심으로 다음 기능을 제공합니다.

  • 전문 검색 : 모든 메시지 내용을 SQLite FTS5로 색인해 전체 텍스트를 검색합니다.
  • 토큰 사용량·비용 대시보드 : 세션별·모델별 비용 내역과 일별 지출 차트를 웹 UI에서 봅니다.
  • 분석 대시보드 : 활동 히트맵, 도구 사용량, 속도 지표, 프로젝트별 분포를 보여줍니다.
  • 최근 편집 피드 : 에이전트가 최근 변경한 파일을 프로젝트·경로별로 묶어, 그 변경을 만든 메시지로 바로 연결합니다.
  • 실시간 업데이트 : 활성 세션에 새 메시지가 들어오면 SSE로 화면을 갱신합니다.
  • 키보드 우선 탐색 : j/k/[/] 이동, Cmd+K 검색, ?로 단축키 도움말을 띄웁니다.
  • 내보내기 : 세션을 HTML로 내보내거나 GitHub Gist로 발행합니다.

agentsview의 세션 메시지 뷰어 화면
agentsview의 세션 메시지 뷰어 화면1440×900 144 KB

agentsview의 전문 검색 결과 화면
agentsview의 전문 검색 결과 화면1440×900 121 KB

agentsview의 토큰 사용량·비용 추적

agentsview usage는 ccusage 같은 도구를 대체하는 빠른 로컬 명령으로, Claude Code뿐 아니라 모든 코딩 에이전트의 토큰 소비와 비용을 추적합니다. 세션 데이터가 이미 SQLite에 색인되어 있어, 실행 때마다 원본 세션 파일을 다시 파싱하는 도구보다 100배 이상 빠르다고 저자는 설명합니다. 가격은 LiteLLM 요율을 자동으로 받아오며(오프라인 폴백 포함), 프롬프트 캐싱(캐시 생성·읽기 토큰)을 반영해 비용을 계산합니다.

# 일별 비용 요약 (기본: 최근 30일)
agentsview usage daily

# 모델별 분해
agentsview usage daily --breakdown

# 에이전트·기간 필터
agentsview usage daily --agent claude --since 2026-04-01

# 셸 프롬프트/상태바용 한 줄 요약
agentsview usage daily --all --json

개별 세션의 토큰 통계와 비용 추정은 agentsview session usage <id>로 확인하며, 같은 데이터를 REST API(GET /api/v1/sessions/{id}/usage)로도 받을 수 있습니다. 세션 단위 분석을 원하면 agentsview stats가 세션 길이·사용자 메시지 수·피크 컨텍스트 분포와 도구·모델·에이전트 구성, 시간대별 활동 등을 버전이 매겨진 JSON 스키마로 출력합니다.

agentsview 설치 및 사용법

agentsview는 단일 설치 스크립트로 설치할 수 있습니다.

# macOS / Linux
curl -fsSL https://agentsview.io/install.sh | bash

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://agentsview.io/install.ps1 | iex"

데스크톱 앱(macOS / Windows)은 GitHub Releases에서 내려받거나 brew install --cask agentsview로 설치할 수 있고, ghcr.io/kenn-io/agentsview Docker 이미지로도 실행할 수 있습니다. 설치 후 기본 흐름은 다음과 같습니다.

agentsview serve               # 포그라운드 서버 시작
agentsview serve --background  # 백그라운드로 시작하고 셸로 복귀
agentsview session list        # 세션 목록 조회
agentsview usage daily         # 일별 비용 요약 출력

agentsview가 지원하는 코딩 에이전트

agentsview는 20종이 넘는 코딩 에이전트의 세션을 자동으로 찾아냅니다. Claude Code(~/.claude/projects/), Codex(~/.codex/sessions/), Cursor, Gemini CLI, Copilot CLI, Forge, OpenCode, Kimi, Qwen Code, OpenHands CLI, Warp, Zed 등이 포함됩니다. 각 디렉토리는 환경 변수로 재정의할 수 있습니다.

다만 일부 에이전트는 별도 설정이 필요합니다. Aider는 중앙 세션 저장소가 없어 저장소별 .aider.chat.history.md 로그를 쓰므로 AIDER_DIR(또는 aider_dirs)로 스캔할 코드 루트를 직접 지정해야 합니다. JetBrains의 Copilot 채팅은 agentsview가 직접 읽지 못해, copilot-jetbrains-exporter로 JSONL로 내보낸 뒤 그 디렉토리를 가리키는 방식이 지원됩니다.

agentsview의 라이선스

agentsview는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.

:house: agentsview 공식 홈페이지

:github: agentsview 프로젝트 GitHub 저장소

더 읽어보기



이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. :hugs:

:pytorch:파이토치 한국 사용자 모임:south_korea:이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일:love_letter:로 보내드립니다!
텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다. :smiley:

:wrapped_gift: 아래:down_right_arrow:쪽에 좋아요:+1:를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ :star_struck: