원문 캡처 · github.com
원문 캡처 · github.com

TraceQuest는 Claude Code, Codex CLI, Cursor 등 여러 코딩 에이전트의 세션을 로컬에서 검색하고 분석하는 웹 앱 겸 CLI다. 도구 호출과 오류, 토큰 사용량을 살펴보고 여러 세션을 비교할 수 있다.

Claude Code, Codex CLI, Cursor, Droid (Factory), OpenCode, Grok CLI, vktr, fx, DeepSeek Harness의 세션을 읽으며 Cursor Cloud Agent 세션도 가져올 수 있다. SSH로 다른 컴퓨터의 세션을 복사하는 기능도 제공한다.

세션 목록에서 메시지를 검색하고 프로젝트·출처·컴퓨터·모델·도구·오류 수·기간으로 필터링할 수 있다. 분석 화면은 실패한 도구 호출을 원인별로 묶고 오류율과 재시도, 반복 실행, 활성 시간, 예상 비용을 보여준다. 제작자는 분석이 로컬에서 실행되며 모델을 호출하지 않는다고 설명한다. 비용은 토큰 수와 모델 가격을 바탕으로 추정한 값이며 실제 청구액은 아니다.

세션을 HTML이나 Markdown으로 내보낼 수 있고, 두 세션의 실행 시간·토큰·오류·재시도 등을 나란히 비교할 수 있다. TraceQuest에서 에이전트를 새로 실행하거나 일부 세션을 이어서 진행하려면 tmux가 필요하다.

체험판에는 Node.js 22.5 이상과 git이 필요하다. 저장소를 내려받고 npm install을 실행한 뒤 npm run demo로 시작하면 localhost:7777에서 샘플 세션 두 개를 볼 수 있다. 데모에는 에이전트 계정이나 API 키가 필요하지 않다. 자신의 세션을 보려면 데모를 종료하고 npm start를 실행한다. 설치와 사용 설명서

세션 탐색과 분석은 로컬 파일만 읽으며 TraceQuest는 원격 측정 데이터를 보내지 않는다. 세션 공유, 원격 세션 가져오기, 사용량 한도 확인을 요청할 때는 다른 서비스에 접속한다. 기본 서버는 로그인 없이 localhost에서 실행되므로 다른 컴퓨터에서 접근 가능하게 설정하기 전 배포 안내와 보안 안내를 확인해야 한다. SSH 허브는 읽기 전용이며 비밀정보처럼 보이는 값을 숨기지만, 세션에는 대화 내용이 남으므로 네트워크 접근을 제한해야 한다.

프로젝트 저장소 · 문서