Agentlytics 소개
요즘 개발자들은 코드 작성 시 다양한 AI 어시스턴트의 도움을 받는 것이 일상화되었습니다. 특정 프로젝트에는 Cursor를 사용하고, 다른 작업에는 Windsurf나 Claude Code, 또는 VS Code Copilot을 혼용하는 경우가 매우 흔합니다. 하지만 이렇게 여러 종류의 AI 코딩 에디터를 넘나들며 작업하다 보면, 각 도구마다 대화 기록과 사용 내역이 파편화되는 문제가 발생합니다. 내가 어떤 프롬프트를 통해 버그를 해결했는지 찾으려면 여러 에디터를 일일이 열어 확인해야 하는 번거로움이 있습니다. 또한 여러 모델의 API를 동시에 사용하면서 발생하는 AI 토큰 소모량과 지출 비용을 한눈에 파악하는 것은 사실상 불가능에 가까웠습니다.
Agentlytics는 이처럼 파편화된 AI 코딩 환경의 불편함을 해소하기 위해 등장한 혁신적인 로컬 기반 통합 분석 대시보드입니다. 단 한 줄의 명령어만 실행하면 내 PC에 설치된 최대 16종의 AI 코딩 에디터 데이터를 자동으로 읽어와 하나의 인터페이스에 깔끔하게 정리해 줍니다. 특히 클라우드 서버에 데이터를 전송하거나 별도의 회원가입을 거칠 필요 없이, 오직 개발자 개인의 로컬 환경에 존재하는 SQLite 데이터베이스와 JSONL 로그 파일만을 직접 읽어 분석합니다. 덕분에 민감한 사내 코드나 개인적인 대화 기록이 외부로 유출될 걱정 없이 100% 안전하게 사용할 수 있습니다. 단순히 과거의 세션을 열람하는 것을 넘어서, 개발자 개인의 생산성을 다각도에서 진단하는 강력한 회고 도구로 활용할 수 있습니다.
Agentlytics는 개인의 작업 내역 분석뿐만 아니라 팀 단위의 협업까지 고려하여 설계된 것이 큰 특징입니다. 어떤 에디터가 나의 작업 스타일에 가장 효율적인지 비교 분석하고, 가장 활발하게 코딩하는 피크 시간대와 코딩 연속 기록(Streaks) 등을 시각적인 대시보드로 제공합니다. 더 나아가 Relay 기능과 MCP(Model Context Protocol) 연동을 통해, 내 로컬 환경에만 갇혀 있던 유용한 AI 문제 해결 과정을 같은 네트워크를 공유하는 팀원들과 손쉽게 나눌 수 있습니다. 끊임없이 진화하고 복잡해지는 AI 개발 생태계 속에서, Agentlytics는 개발자들이 자신의 코딩 습관을 데이터 기반으로 점검하고 AI 도구 활용 능력을 극대화하도록 돕는 필수적인 나침반 역할을 할 것입니다.
Agentlytics의 주요 특징
원클릭 실행과 지원 환경
Agentlytics는 현재 개발자들이 주로 사용하는 대부분의 AI 코딩 도구를 지원하도록 설계되었습니다:
-
지원 도구: Cursor, Windsurf, Claude Code, VS Code Copilot, Zed, Antigravity, OpenCode, Command Code 등
-
시스템 요구사항: Node.js 20.19 이상 또는 22.12 이상 환경이 필요하며, 현재는 macOS에 최적화되어 있습니다. (Linux 및 Windows 지원은 커뮤니티 기여를 통해 추가되고 있습니다.)
-
실행 방법: 터미널에서 다음 명령어를 실행하면 별도의 설치 과정 없이
http://localhost:4637포트에서 대시보드가 즉시 열립니다.npx agentlytics
통합 대시보드 및 상세 분석 지표
수집된 로컬 로그를 바탕으로 개발자의 AI 활용 패턴을 정밀하게 분석하여 다양한 리포트를 제공합니다:
-
핵심 지표(KPIs) 및 활동 히트맵: 전체 세션 수, 메시지 수, 총 토큰 사용량을 한눈에 보여주며, 코딩 연속 기록(Streaks)과 가장 코딩을 많이 하는 피크 시간대를 히트맵으로 제공합니다.
-
비용 및 구독 관리: API 토큰 사용량을 기반으로 모델 및 에디터별 지출 비용을 추정합니다. 또한 각 에디터의 구독 플랜, 사용 쿼터, 남은 크레딧 및 Rate Limit 등을 실시간으로 종합하여 보여줍니다.
-
프로젝트별 딥 드릴다운 (Deep Analysis): 특정 디렉토리(프로젝트)에서 어떤 에디터와 모델을 주로 사용했는지 파악할 수 있습니다. 특히
edit_file,read_file과 같은 AI의 도구 호출(Tool call) 빈도를 히트맵과 분포도로 상세하게 분석합니다. -
세션 탐색기 (Sessions Explorer): 코드 하이라이팅이 적용된 뷰어를 통해 과거의 모든 AI 대화 내역을 원문 그대로 읽을 수 있으며, 슬라이드 오버(Slide-over) 사이드바 형태로 제공되어 분석 흐름을 끊지 않습니다. 필요시 PDF나 CSV로 리포트를 내보낼 수도 있습니다.
데이터 수집 아키텍처 및 알려진 한계점
Agentlytics는 클라우드 서버에 의존하지 않고, 사용자의 PC에 저장된 SQLite 데이터베이스, 상태(State) 파일, JSONL 로그를 직접 파싱하여 데이터를 구성합니다. 하지만 에디터의 구조적 차이로 인한 기술적 한계점도 존재합니다. Cursor나 Claude Code는 로컬 파일 시스템에서 직접 기록을 읽어올 수 있어 원활한 오프라인 분석이 가능합니다.
반면, Windsurf나 Antigravity 같은 에디터는 Language Server 프로세스에서 ConnectRPC를 통해 데이터를 가져오는 방식을 사용하므로, 캐스케이드(Cascade) 히스토리를 저장하는 명확한 로컬 파일 구조가 아직 밝혀지지 않았습니다. 따라서 해당 에디터들의 분석 데이터를 정상적으로 수집하려면 에디터 앱이 백그라운드에서 실행 중인 상태여야 한다는 제약이 있습니다.
Agentlytics는 지원하는 에디터별 지원 기능들을 다음과 같이 정리하고 있습니다:
| Editor | Msgs | Tools | Models | Tokens |
|---|---|---|---|---|
| Cursor | ||||
| Windsurf | ||||
| Windsurf Next | ||||
| Antigravity | ||||
| Claude Code | ||||
| VS Code | ||||
| VS Code Insiders | ||||
| Zed | ||||
| OpenCode | ||||
| Codex | ||||
| Gemini CLI | ||||
| Copilot CLI | ||||
| Cursor Agent | ||||
| Command Code | ||||
| Goose | ||||
| Kiro |
팀 협업을 위한 Relay와 MCP 연동 아키텍처
단순한 개인용 통계 도구를 넘어, 로컬 네트워크 내에서 팀원들과 AI 컨텍스트를 안전하게 공유하는 Relay 기능을 지원합니다.
- Relay 서버 참여: 한 사용자가 Relay 서버를 열면, 다른 팀원들은 특정 프로젝트 경로에서
--join옵션으로 참여하여 자신의 프로젝트 세션을 공유할 수 있습니다.git config user.email을 통해 유저명을 자동 감지하며, 환경 변수를 통해 비밀번호 보호도 가능합니다.
cd /path/to/your-project
RELAY_PASSWORD=secret npx agentlytics --join
-
Relay REST API: 백엔드 및 외부 확장을 위한 통신 규격을 제공합니다:
GET /relay/health: 서버의 정상 작동 여부 및 현재 연결된 사용자 수를 반환합니다.GET /relay/users: 현재 네트워크에 연결된 사용자 목록을 조회합니다.GET /relay/search?q={query}: 참여 중인 모든 사용자의 대화 메시지를 대상으로 통합 검색을 수행합니다.
-
MCP 연동: Relay를 통해 팀의 통합된 데이터가 MCP 서버로 노출되므로, 사용 중인 AI 에이전트가 이 서버를 참조하여 팀원 전체의 문제 해결 지식 기반에 접근하게 만들 수 있습니다.
라이선스
Agentlytics 프로젝트는 MIT 라이선스로 공개 및 배포 되고 있습니다.
Agentlytics 홈페이지
Agentlytics 프로젝트 GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. ![]()
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ ![]()

