AgentsView로 AI 코딩 에이전트 세션을 한눈에 관리하는 방법

AI 코딩 에이전트를 활용하는 개발 환경에서는 하나의 프로젝트에서도 Claude Code, Codex, Cursor, Gemini CLI, OpenCode 등 여러 도구를 함께 사용하는 경우가 많습니다. 하지만 각 에이전트의 대화 기록과 사용량, 비용, 작업 이력을 각각 확인해야 하는 불편함이 존재합니다.

AgentsView는 이러한 문제를 해결하기 위해 다양한 AI 코딩 에이전트의 세션을 자동으로 수집하고 검색, 분석, 비용 추적까지 지원하는 오픈소스 도구입니다. 로컬 환경에서 실행되며 웹 대시보드와 CLI를 통해 프로젝트별 작업 현황과 AI 사용 패턴을 효율적으로 관리할 수 있습니다.

이번 글에서는 AgentsView의 주요 기능과 특징, 제공하는 분석 정보, 활용 방법을 중심으로 살펴보겠습니다.

반응형

---

AgentsView란?

AgentsView는 다양한 AI 코딩 에이전트에서 생성되는 세션 데이터를 하나의 환경에서 통합 관리할 수 있는 분석 도구입니다.

지원하는 대표적인 에이전트는 다음과 같습니다.

• Claude Code
• Codex
• Cursor
• Gemini CLI
• OpenCode
• 기타 다양한 AI 코딩 에이전트

처음 실행하면 로컬에 저장되어 있는 세션 파일을 자동으로 탐색하여 SQLite 데이터베이스에 색인합니다. 이후 웹 브라우저에서 127.0.0.1:8080으로 접속하면 대시보드를 통해 모든 세션을 확인할 수 있습니다.

또한 Go 단일 바이너리 형태로 제공되기 때문에 별도의 복잡한 설치 과정 없이 실행할 수 있는 것이 특징입니다.

---

주요 기능

다양한 AI 코딩 에이전트 세션 자동 수집

AgentsView는 여러 AI 코딩 도구에서 생성되는 세션을 자동으로 수집합니다.

이를 통해 여러 도구를 오가며 대화 기록을 확인할 필요 없이 하나의 화면에서 프로젝트별 작업 내역을 확인할 수 있습니다.

지원하는 일부 에이전트는 로컬에 전체 대화를 저장하지 않는 구조이므로, 이 경우에는 요약 정보만 제공될 수 있습니다.

---

통합 세션 검색

여러 프로젝트와 수많은 대화가 쌓일 경우 원하는 내용을 찾는 것은 쉽지 않습니다.

AgentsView는 SQLite FTS5 기반의 전체 텍스트 검색을 제공하여 필요한 세션을 빠르게 검색할 수 있습니다.

추가로 OpenAI 호환 임베딩을 연결하면 다음 기능도 사용할 수 있습니다.

• 의미 기반 검색(Semantic Search)
• 하이브리드 검색

단순 키워드 검색뿐 아니라 의미가 유사한 대화까지 검색할 수 있어 과거 작업을 더욱 효율적으로 찾을 수 있습니다.

---

토큰 및 비용 추적

AI 서비스를 사용할수록 토큰 사용량과 비용 관리의 중요성은 더욱 커집니다.

AgentsView는 다음 정보를 자동으로 집계합니다.

• 에이전트별 사용량
• 날짜별 사용량
• 모델별 토큰 사용량
• 예상 비용

비용 계산에는 LiteLLM 가격표가 반영되며 다음 요소도 함께 계산됩니다.

• 프롬프트 캐시 생성 토큰
• 프롬프트 캐시 읽기 토큰

CLI에서는 다음 명령으로 사용량을 확인할 수 있습니다.

• agentsview usage daily
• agentsview session usage <id>

또한 이미 색인된 SQLite 데이터를 조회하기 때문에 원본 세션 파일을 매번 다시 분석하는 방식보다 100배 이상 빠른 조회 성능을 제공합니다.

---

세션 분석 기능

AgentsView는 단순히 세션을 저장하는 것을 넘어 작업 특성을 분석합니다.

세션은 다음과 같이 분류됩니다.

• 자동화 작업
• 짧은 작업
• 표준 작업
• 깊은 작업
• 장시간 작업

추가로 다음과 같은 다양한 정보를 제공합니다.

• 세션 지속 시간
• 메시지 수
• 최대 컨텍스트 크기
• 턴당 도구 사용량
• 캐시 효율

이를 통해 AI 활용 패턴과 작업 특성을 객관적으로 분석할 수 있습니다.

---

변경 파일 추적

Recent Edits 기능을 이용하면 여러 AI 에이전트가 최근 수정한 파일을 프로젝트별, 경로별로 확인할 수 있습니다.

또한 실제 파일 변경이 어떤 대화에서 발생했는지까지 추적할 수 있어 작업 이력을 관리하는 데 도움을 줍니다.

---

실시간 대시보드

AgentsView는 SSE(Server-Sent Events)를 이용해 진행 중인 세션을 실시간으로 갱신합니다.

대시보드에서는 다음과 같은 정보를 확인할 수 있습니다.

• 활동 히트맵
• 프로젝트별 통계
• 모델 사용량
• 도구 사용량
• 일별 지출 차트

AI 활용 현황을 시각적으로 확인할 수 있어 프로젝트 관리에도 활용할 수 있습니다.

---

다양한 세션 형식 지원

AgentsView는 여러 AI 도구의 저장 형식을 지원합니다.

예를 들어 다음과 같은 형식도 지원 대상입니다.

• Aider 저장소별 Markdown 로그
• JetBrains Copilot 내보내기 파일
• Antigravity CLI 사이드카

덕분에 특정 도구에 종속되지 않고 다양한 개발 환경에서 활용할 수 있습니다.

---

데이터 공유 및 확장

수집된 SQLite 데이터는 다양한 환경으로 확장할 수 있습니다.

지원하는 예시는 다음과 같습니다.

• PostgreSQL 기반 팀 대시보드
• DuckDB 미러
• S3 호환 저장소(Claude, Codex 세션)

개인 개발 환경뿐 아니라 팀 단위 분석 환경으로도 확장이 가능합니다.

---

AgentsView 활용 예시

예를 들어 여러 AI 코딩 에이전트를 사용하는 프로젝트에서는 다음과 같은 흐름으로 활용할 수 있습니다.

1. AgentsView를 실행하여 로컬 세션을 자동 색인합니다.
2. 웹 대시보드(127.0.0.1:8080)에서 프로젝트별 세션을 확인합니다.
3. 필요한 대화를 전체 텍스트 검색 또는 의미 검색으로 빠르게 찾습니다.
4. CLI를 이용해 일별 토큰 사용량과 비용을 확인합니다.
5. Recent Edits에서 최근 수정된 파일과 관련 대화를 추적합니다.
6. 대시보드를 통해 프로젝트별 AI 활용 현황과 비용을 지속적으로 관리합니다.

이러한 과정을 통해 여러 AI 도구를 사용하는 개발 환경에서도 세션 관리와 비용 분석을 체계적으로 수행할 수 있습니다.

---

AgentsView의 특징 정리

AgentsView의 핵심 특징은 다음과 같습니다.

• 다양한 AI 코딩 에이전트 세션 자동 수집
• SQLite 기반의 빠른 검색 성능
• 의미 검색 및 하이브리드 검색 지원
• 토큰 및 비용 자동 계산
• 세션 활동 분석 기능 제공
• 변경 파일 추적 지원
• 실시간 대시보드 제공
• 다양한 세션 형식 지원
• PostgreSQL, DuckDB, S3 등으로 확장 가능
• Go 단일 바이너리 기반의 간편한 실행

---

728x90

AI 코딩 에이전트를 적극적으로 활용하는 개발 환경에서는 작업 기록과 비용, 프로젝트별 활동을 체계적으로 관리하는 것이 점점 중요해지고 있습니다.

AgentsView는 여러 AI 코딩 에이전트의 세션을 하나의 환경에서 통합 관리하고, 검색, 분석, 비용 추적, 변경 이력 확인까지 지원하는 오픈소스 도구입니다. 특히 SQLite 기반의 빠른 검색, 다양한 분석 기능, 실시간 대시보드 제공을 통해 AI 활용 현황을 보다 효율적으로 파악할 수 있도록 돕습니다.

여러 AI 코딩 도구를 함께 사용하는 개발자나 팀이라면 AgentsView를 활용해 세션 관리와 비용 분석을 보다 체계적으로 수행할 수 있을 것으로 기대됩니다.

300x250

https://github.com/kenn-io/agentsview

GitHub - kenn-io/agentsview: Local-first session search, analytics, insights, and token use statistics for coding agents, suppor