taco-claude-plugin

taco(AI 코딩 사용량·비용 트래커)의 Claude Code 플러그인. Claude Code 세션 이벤트(hook)마다 taco CLI 를 호출해 세션 transcript 의 토큰 사용량을 수집하고, taco MCP 서버(사용량 조회 도구)를 함께 등록한다.

이 레포는 hook 등록 + MCP 등록 + 얇은 래퍼 스크립트만 담는다. 실제 파싱/필터/ 전송 로직은 전부 taco CLI 안에 있다.

사전 조건: taco CLI

taco CLI 가 PATH 에 있어야 한다.

# macOS / Linux
curl -fsSL https://inf.run/taco | sh

# Windows (PowerShell)
irm https://inf.run/taco.ps1 | iex

설치 후 로그인:

taco login

설치

claude plugin marketplace add inflearn/taco-claude-plugin
claude plugin install taco@inflearn

설치 후 Claude Code 를 다시 시작하면 hook 과 MCP 서버가 등록된다. 이후 세션마다 Stop / SubagentStop / PreCompact / SessionEnd 이벤트에서 transcript 가 증분 수집되고, /mcp 에서 taco 도구(사용량·세션 조회)를 쓸 수 있다.

동작

Claude Code hook (Stop/SubagentStop/PreCompact/SessionEnd)
  → taco hook   (async, stdin = hook 이벤트 JSON)
    → transcript 증분 파싱 → 로컬 버퍼
      → auto_sync 켜진 경우 → taco 서버

• 자동 sync 는 기본 OFF. 기본은 로컬 버퍼에만 쌓이고, 전송은 taco sync 또는 taco init 에서 auto_sync 활성화 시.
• 수집 대상은 allowed_orgs / allowed_dirs 필터를 따른다.
• 래퍼는 CLI 를 못 찾아도 조용히 종료 — 에디터를 절대 막지 않는다.

구성

파일	역할
.claude-plugin/plugin.json	플러그인 매니페스트
.claude-plugin/marketplace.json	marketplace 레지스트리 매니페스트
hooks/hooks.json	hook 이벤트 → taco hook 등록 (async)
.mcp.json	taco MCP 서버 등록

문서 · 대시보드

• 문서: https://taco.inflab.com/docs
• 대시보드: https://taco.inflab.com

라이선스

MIT