taco docs
설치대시보드GitHub
시작하기
개요빠른 시작윈도우 설치 (비개발자)설치설정
수집
지원 도구CLI 명령
대시보드
대시보드 둘러보기티켓별 비용
연동
MCP 서버Jira·GitHub 연동
기타
문제 해결

지원 도구

taco는 각 AI 코딩 도구가 로컬에 남기는 기록을 읽어 사용량 이벤트로 변환합니다. 도구별로 소스 위치와 수집 방식이 다릅니다.

지원 목록

도구소스 경로형식
Claude Code~/.claude/projects/*.jsonlJSONL (assistant 메시지의 usage)
Codex~/.codex/sessions/rollout-*.jsonlJSONL
Cursorstate.vscdb (cursorDiskKV)SQLite
Gemini~/.gemini/tmp/*/chats/session-*.json[l]JSON/JSONL
Antigravity~/.gemini/antigravity*/conversations/*.dbSQLite

각 이벤트에서 입력/출력/캐시 토큰, 모델, 세션, 작업 경로(cwd), git 브랜치·레포를 뽑고, 서버가 모델 단가를 적용해 비용을 계산합니다.

수집 방식

  • Claude Code·Codex는 플러그인 hook이 이벤트마다 자동 수집합니다. 플러그인은 taco plugins(설치 스크립트가 자동 실행)로 설치됩니다.
  • Cursor·Gemini·Antigravity는 hook 없이 taco collect(또는 다른 hook 실행 시 사이드카 스캔)가 로컬 기록을 스캔해 수집합니다. 별도 로그인/연동은 필요 없고, 파일이 있으면 읽습니다.
  • 각 파일은 watermark(마지막으로 읽은 위치)를 기록해, 새로 추가된 부분만 증분 수집합니다. 처음부터 다시 읽으려면 taco collect --full.

특정 도구만 수집하려면:

taco collect --provider claude --provider codex

필터 적용

수집된 이벤트는 설정의 allowed_orgs·allowed_dirs 필터를 통과해야 적재됩니다.

  • git remote가 있는 이벤트는 org 필터를 받습니다(기본 inflearn).
  • allowed_dirs가 설정되면 그 하위 경로의 작업만 수집됩니다.

로컬 대화 열람

로컬 대시보드(taco dashboard)에서는 세션의 대화 원문(프롬프트·응답·툴 호출)까지 열람할 수 있으며, 모든 provider(claude/codex/cursor/gemini/antigravity)를 지원합니다. MCP의 taco_session·taco_search도 이 로컬 대화를 읽습니다.

비용 산정

  • 모델 단가는 LiteLLM 피드를 동기화해서 씁니다. 로컬은 taco pricing sync, 서버는 자동 동기화 + 과거 이벤트 소급 반영.
  • 단가가 아직 없는 모델은 비용 0으로 적재되고, 이후 단가가 채워지면 소급 계산됩니다.

다음

  • CLI 명령 — collect/sync/hook 사용법
  • 설정 — 수집 범위 조정
이 페이지
지원 목록수집 방식필터 적용로컬 대화 열람비용 산정다음