CLI 명령

taco <command> 형태로 사용합니다. taco --help, taco <command> --help로 언제든 확인할 수 있습니다.

공통 플래그 · 환경변수

대부분의 명령이 아래를 공유합니다(우선순위: 플래그 > env > config > 기본값).

대상	플래그	env
서버 URL	`--server`	`TACO_SERVER`
로컬 DB 경로	`--local-db`	`TACO_LOCAL_DB`
OAuth 서버	`--oauth-server`	`TACO_OAUTH_SERVER`

init

설정 + 로그인 + 도구 연동 안내(대화형).

taco init

auto_sync 여부를 묻고, 이어서 인프런 OAuth 로그인을 진행합니다. org/디렉터리 제한은 묻지 않으며(기본 제한 없음), 필요하면 --allowed-orgs·--allowed-dirs 플래그로 지정합니다. → 설정

대부분은 taco init이 필요 없습니다 — 설치 스크립트가 플러그인 연동(taco plugins)과 로컬 수집을 자동으로 하고, taco login이 로그인+첫 전송을 합니다. init은 수집 범위·auto_sync를 세밀하게 바꿀 때만.

plugins

로컬에 설치된 AI 코딩 도구를 감지해 taco 플러그인을 설치합니다. taco claude·taco codex를 대체하는 통합 명령입니다.

taco plugins

기본은 전체 설치 — 감지된 도구(Claude Code·Codex 등) 전부에 플러그인을 설치합니다.
대화형 터미널에서는 목록을 보여주고, 빼고 싶은 도구만 번호로 골라 끌 수 있습니다.
Cursor·Gemini·Antigravity는 플러그인 없이 자동 수집되므로 설치 대상이 아니며, 감지되면 안내만 표시합니다.
설치 스크립트(curl … | sh)가 설치 직후 이 명령을 자동 실행합니다.

플래그	설명
`--plugin-path`	git 마켓플레이스 대신 로컬 체크아웃에서 설치(사설 저장소 인증 우회)

인프런 OAuth 로그인(브라우저 1회) 후, 그동안 로컬에 쌓인 사용량을 서버로 첫 전송합니다. 설치는 수집까지만 하고, 전송은 로그인부터 시작합니다.

taco login

collect

로컬 기록을 한 번 스캔해 이벤트를 적재합니다(수동/디버그용, 평소엔 hook이 자동).

taco collect                 # 증분 수집(auto_sync 기본 ON이면 전송까지)
taco collect --no-sync       # 로컬 버퍼에만 적재(전송 안 함) — 설치 스크립트가 로그인 전에 사용
taco collect --sync          # 수집 + 서버 전송(강제)
taco collect --full --sync   # watermark 리셋 후 전체 재수집 + 전송
taco collect --provider claude --provider codex

플래그	설명
`--full`	watermark 리셋 후 모든 파일 재수집
`--sync`	수집 후 서버 전송(`auto_sync`와 별개로 강제)
`--no-sync`	로컬에만 적재, 절대 전송 안 함(로그인 전 설치 단계용)
`--provider`	특정 provider만(반복 지정)

sync

로컬 버퍼에 쌓인 미전송 이벤트를 서버로 보냅니다.

taco sync

hook

에디터 플러그인이 hook 이벤트(stdin JSON)마다 호출합니다. 직접 실행할 일은 거의 없습니다. 하나의 transcript를 파싱해 적재하고, auto_sync면 서버로 전송합니다.

stats

사용량 요약(비용·토큰·이벤트).

taco stats              # 로컬 기준
taco stats --remote     # 서버 기준(본인)

show · search

세션 조회/검색.

taco show               # 최근 세션
taco search <키워드>     # 로컬 대화에서 검색

status

마지막으로 수집·전송된 시각과 현재 상태를 한눈에 보여줍니다. "잘 쌓이고 있나?"를 빠르게 확인할 때 좋습니다.

taco status

doctor

설정/로그인/로컬 DB/전송 큐 상태를 진단합니다. 문제가 있을 때 먼저 실행하세요.

taco doctor

statusline

오늘 사용량을 한 줄로. 쉘 프롬프트/상태줄에 넣기 좋습니다.

taco statusline
# 🌮 $1.23 · 45.6K tok · 12 ev (오늘)

pricing

모델 단가 관리.

taco pricing sync            # LiteLLM 피드에서 단가 동기화
taco pricing path            # 동기화된 단가 파일 경로
taco pricing show <model>    # 특정 모델 단가 확인

dashboard

로컬 데이터로 오프라인 웹 대시보드를 띄웁니다(세션 대화 열람 포함).

taco dashboard               # 로컬 데이터
taco dashboard --remote      # 서버(본인) 데이터로 열기

mcp

read-only MCP 서버(stdio)를 실행합니다. 보통 Claude Code 플러그인이 자동 등록하므로 직접 실행할 일은 드뭅니다. → MCP 서버

taco mcp