서론 (Introduction)

"Gartner의 예측: 토큰 소비가 급증함에 따라 2028년까지 AI 코딩 비용이 평균 개발자 급여를 넘어설 것입니다."

이 글은 Open Source Project of the Day 시리즈의 #117번째 기사입니다. 오늘의 프로젝트는 AgentsView로, AI 코딩 에이전트를 위한 로컬 우선 (local-first) 분석 및 세션 관리 도구입니다.

어떤 작업에는 Claude Code를 사용하고, 다른 모듈에는 Cursor를, 자동화 스크립트에는 Codex를 사용합니다. 각 도구는 각자의 디렉토리에 각자의 형식으로 자체 세션 기록을 가지고 있습니다. 여러분은 다음과 같은 질문을 던지고 싶을 것입니다: 이번 달에 AI 코딩 도구에 얼마나 지출했는가? 어떤 에이전트를 가장 많이 사용하는가? 어떤 세션을 다시 검토할 가치가 있는가? 이에 대한 통합된 답변은 존재하지 않습니다.

AgentsView는 한 가지 일을 직접 수행합니다: 모든 에이전트 세션 데이터를 로컬 SQLite 데이터베이스로 인덱싱(indexing)한 다음, 통합 검색 인터페이스, 비용 분석 및 대시보드를 제공합니다. 단일 바이너리(Single binary)로 작동하며, 로컬에서 실행되고, 계정이 필요 없으며, 데이터는 사용자의 기기에 그대로 유지됩니다.

학습 내용

• AgentsView의 아키텍처: Go + SQLite + Svelte, 그리고 왜 원본 파일을 다시 파싱하는 것보다 100배 더 빠른가
• 지원되는 30개 이상의 에이전트와 해당 세션 디렉토리 경로
• 실용적인 CLI 명령: 일일 비용 요약, 세션 목록, 통계
• PostgreSQL 팀 동기화 및 DuckDB 분석 미러링
• 다중 기기 중앙 집중식 세션 관리를 위한 S3 지원
• 개인정보 보호 설계: DNS-rebinding 보호, 로컬 바인딩, 익명 텔레메트리 (anonymous telemetry)

사전 요구 사항

• Claude Code, Cursor 또는 유사한 AI 코딩 도구의 정기 사용자
• AI 도구의 토큰 비용 추적에 대한 관심

프로젝트 배경 (Project Background)

AgentsView란 무엇인가?

AgentsView는 로컬 우선 (local-first) AI 에이전트 세션 분석 플랫폼입니다. 핵심 로직은 다음과 같습니다: 모든 AI 코딩 도구는 세션 기록을 서로 다른 형식의 로컬 파일로 작성하지만, 모두 파일입니다. AgentsView는 해당 파일들을 파싱(parse)하여 통합된 SQLite 인덱스를 구축하고, 통합 쿼리 및 분석 인터페이스를 제공합니다.

이 도구는 어떤 도구의 작동 방식도 변경하지 않습니다. 프록시 계층 (proxy layer)을 삽입하지도 않습니다. 단지 이미 존재하는 데이터를 쿼리(query) 가능하게 만들 뿐입니다.

저자 (Author)

저자 (Author)

• 저자: kenn-io
• 웹사이트: agentsview.io
• 라이선스: MIT

프로젝트 통계 (Project Stats)

• ⭐ GitHub Stars: ~4,000
• 🍴 Forks: ~305
• 📄 라이선스: MIT
• 💻 언어: Go 81.1% / TypeScript 10.7% / Svelte 5.9% / Rust 1.1%

핵심 기능 (Core Features)

다중 에이전트 자동 검색 (Multi-Agent Auto-Discovery)

AgentsView는 30개 이상의 주요 AI 코딩 도구의 세션 디렉터리를 자동으로 스캔합니다:

Agent	Session Directory
Claude Code	~/.claude/projects/
...
모든 디렉터리 경로는 환경 변수를 통해 재정의(overridable)할 수 있습니다.

전체 텍스트 검색 (Full-Text Search)

SQLite FTS5를 기반으로 모든 에이전트의 세션 콘텐츠를 인덱싱합니다. 3주 전 '인증 모듈 리팩토링' 접근 방식을 논의했던 Claude Code 세션을 찾고 있나요? AgentsView의 전체 텍스트 검색 기능은 즉시 찾아줍니다. 수동 디렉터리 탐색이나 원본 JSONL 파일을 grep할 필요가 없습니다.

토큰 및 비용 추적 (Token and Cost Tracking)

AgentsView는 각 에이전트의 세션 데이터에서 토큰 사용량과 모델 메타데이터를 추출하여 비용 보기(cost view)를 구축합니다:

# 오늘의 비용 요약
agentsview usage daily

...

일반적인 출력 예시:

Daily Usage — 2026-07-07
─────────────────────────────────────────
Agent        Sessions  Input Tok   Output Tok  Cost
...

분석 대시보드 (Analytics Dashboard)

웹 UI(http://127.0.0.1:8080)를 통해 다음을 제공합니다:

• 사용량 히트맵: 일별 및 시간별 활동 추이
• 도구 사용 통계: 가장 자주 호출되는 도구 (bash, read, write 등)
• 속도 지표(Velocity metrics): 세션당 평균 토큰 수, 작업 완료 소요 시간
• 프로젝트 수준 분석: 프로젝트 디렉터리별 에이전트 사용 패턴

최근 편집 내역 피드 (Recent Edits Feed)

실용적인 기능입니다. 에이전트에 의해 최근 수정된 파일을 프로젝트별로 그룹화하여 표시합니다. 업무가 끝날 무렵, AI가 무엇을 변경했는지 검토하기 위해 git diff를 뒤질 필요 없이 AgentsView가 이를 직접 목록으로 보여줍니다.

실시간 업데이트 (Live Updates)

AgentsView는 데몬 (daemon)으로 실행되어 파일 감시 (file watching)를 통해 새로운 세션 데이터를 모니터링하며, SSE (Server-Sent Events)를 통해 Web UI로 실시간 업데이트를 푸시합니다. 활성화된 AI 세션은 대시보드에 실시간으로 나타납니다.

빠른 시작 (Quick Start)

설치 (Install):

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

...

시작 (Start):

# 포그라운드 모드 (디버깅용)
agentsview serve

...

유용한 CLI 명령어:

# 세션 관리 (Session management)
agentsview session list                        # 모든 세션 목록 표시
agentsview session list --agent claude-code    # Claude Code 세션만 표시
...

심층 분석 (Deep Dive)

파일 재파싱보다 100배 빠른 이유

AI 코딩 도구들은 세션 데이터를 JSONL 또는 Markdown 파일로 기록합니다. 세션 기록은 시간이 지남에 따라 축적되며, 잠재적으로 수천 개의 파일이 될 수 있습니다.

단순한 접근 방식 (Naive approach):
각 검색 또는 분석 → 모든 파일 재스캔 → 각 JSONL 파싱 → 필터링 → 결과 반환
파일 수에 따라 선형적으로 증가합니다. 세션이 50,000개인 경우: 사용 불가능할 정도로 느려짐.
...

증분 동기화 (Incremental sync): 새로운 세션이 기록된 후, 데몬이 파일 변경 사항을 감시하고 새로운 콘텐츠만 처리하므로 전체 재인덱싱 (re-index)이 필요하지 않습니다.

3계층 저장 아키텍처 (Three-Layer Storage Architecture)

SQLite (기본 저장소, 로컬, 쓰기 가능)
    ↓ (선택적 동기화)
PostgreSQL (팀 공유, 읽기 전용 서비스)
...

PostgreSQL 팀 동기화:

# PostgreSQL 백엔드 설정
AGENTSVIEW_POSTGRES_URL=postgresql://user:pass@host/db

...

팀 구성원 각자가 로컬에서 AgentsView를 실행하고 주기적으로 공유 PostgreSQL 데이터베이스에 푸시함으로써, 팀 수준의 AI 사용 대시보드를 생성합니다. 누가 어떤 도구를 사용하는지, 조직 전체의 토큰 소비 트렌드, 가치 있는 세션 아카이빙 등을 확인할 수 있습니다.

DuckDB 미러 (DuckDB mirror):

DuckDB의 Quack 프로토콜은 원격 읽기를 지원하여, 데이터를 파일로 내보내지 않고도 AgentsView 데이터에 대해 직접 SQL 분석 쿼리를 수행할 수 있습니다.

S3 지원

Claude Code 및 Codex 세션 소스는 s3:// 경로로 구성할 수 있습니다:

CLAUDE_CODE_DIR=s3://my-bucket/claude-sessions

여러 대의 기기에서 작업하는 개발자의 경우, 세션 데이터를 S3에 중앙 집중화할 수 있으며 AgentsView는 데이터를 가져온 후 로컬 인덱스 (local index)를 생성합니다.

기술 선택 (Technology Choices)

Go 백엔드 (Go backend): 단일 바이너리 배포, 크로스 플랫폼 지원, 런타임 의존성 없음, 파일 파싱 및 SQLite I/O 집약적 작업에 대한 높은 성능.

Svelte 5 프론트엔드 (Svelte 5 frontend): 경량 프레임워크, 단일 바이너리 배포에 임베딩하기 적합 (프론트엔드 자산이 Go 바이너리에 컴파일됨).

CGO 의존성 (CGO dependency): SQLite 바인딩은 CGO를 필요로 하며, 이는 go install 대신 사전 컴파일된 바이너리 배포를 의미합니다.

Tauri 데스크톱 (Tauri desktop): 동일한 Web UI를 래핑하여 네이티브 macOS 및 Windows 데스크톱 앱 경험을 제공하며, 동일한 로컬 HTTP 서비스로 지원됩니다.

개인정보 보호 설계 (Privacy Design)

데이터 경계 (Data boundaries):
  - 웹 서비스는 127.0.0.1에 바인딩됨 (0.0.0.0 아님)
  - DNS 리바인딩 (DNS-rebinding) 방지: Host 헤더를 검증하고 로컬 데이터에 대한 교차 출처 요청 (cross-origin requests)을 차단함
...

Aider는 선택 사항 (explicit AIDER_DIR 설정 필요)입니다. Aider 히스토리 파일이 저장소 루트 디렉토리에 존재하기 때문에, 자동 스캔 시 macOS 개인정보 보호 프롬프트가 발생할 수 있기 때문입니다.

사용 사례 (Use Cases)

개인 개발자:

• 월간 AI 도구 지출액 및 어떤 도구가 최고의 가성비 (cost-to-value ratio)를 제공하는지 확인
• 3주 전 세션에서 사용했던 접근 방식을 검색
• 개인의 AI 사용 패턴 이해

팀 기술 리드 (Team Tech Leads):

• PostgreSQL 동기화를 통해 팀 수준의 AI 사용 대시보드 구축
• 조직 전체의 AI 도구 비용 트렌드 추적
• 팀 지식 아카이빙을 위한 가치 높은 세션 식별

헤비 AI 도구 사용자:

• 30개 이상의 도구를 전환하며 사용하므로 통합된 세션 히스토리 진입점이 필요함
• 유사한 작업 유형에 대해 서로 다른 에이전트들의 효율성과 비용을 비교

링크 및 리소스 (Links and Resources)

• 🌟 GitHub: kenn-io/agentsview
• 🌐 Website: agentsview.io
• 📖 토큰 추적 문서 (Token tracking docs): agentsview.io/token-usage

결론 (Conclusion)

AgentsView는 AI 코딩 도구가 확산됨에 따라 더욱 현실적인 문제가 되고 있는 문제를 해결합니다. 즉, 여러 도구를 사용하면서 각 도구가 자체적으로 데이터를 관리하기 때문에, 전체적인 사용량과 비용에 대한 가시성을 확보할 수 없다는 점입니다.

Gartner의 2026년 전망 — 2028년까지 AI 코딩 비용이 개발자 급여를 추월할 것이라는 예측 — 은 과장이 아닙니다. Claude Code 사용자의 중앙값은 이미 하루에 6달러를 지출하고 있습니다. 30명 규모의 팀이 1인당 하루 10달러를 사용한다면 연간 100만 달러에 달합니다. 이 정도 규모에서는 '지출에 대한 가시성 부재'와 '데이터에 기반한 의사결정' 사이의 격차가 실질적인 문제가 됩니다.

로컬 우선 (Local-first), 단일 바이너리 (Single binary), 계정 불필요, 데이터의 로컬 머신 유지와 같은 AgentsView의 설계 선택은 도입 시의 마찰과 개인정보 보호에 대한 우려를 동시에 줄여줍니다. 매일 AI 코딩 도구를 집중적으로 사용하는 개발자들에게 이 도구를 설치하고 시도해 보는 것은 비용 부담이 적으며, 유용한 통찰력을 제공할 가능성이 높습니다.

엄선된 AI 에이전트와 기술을 위한 마켓플레이스인 PrimeSkills를 살펴보세요. 각 기술은 실제 기업 워크플로우에서 검증되었으며, 과장된 광고를 걷어내고 진정으로 작동하는 것들만 담았습니다.

더 유용한 통찰력과 흥미로운 제품들을 확인하시려면 저의 홈페이지를 방문해 주세요.