Guide

설명서

VSCode 터미널에서 첫 설치 명령어 입력 이후 재실행 명령어만 입력하면 됩니다.
Windows 및 macOS / Linux 환경에서 모두 동일하게 동작합니다.
최초 설치 시에는 PC에 Python이 설치되어 있어야 합니다.

처음 1회 설치 / 업데이트

macOS / Linux 기준 설치 명령어입니다.
이 명령어를 실행하면 사용자 로컬 홈 디렉토리에 트래커가 설치되며
어떤 워크스페이스에서든 같은 트래커를 재사용할 수 있습니다.
리포트에 update available 이 보일 때도 같은 명령을 다시 실행하면 최신 버전으로 덮어씁니다.

/usr/bin/curl -fsSL 'https://agent-usage-tracker.vercel.app/api/install/python' | python3

다시 실행

이후에는 재설치할 필요 없이 아래 명령어로 트래커만 재시작하면 됩니다.

cd ~/.agent-usage-tracker && python3 track_agent_usage.py

이름 변경

이미 설치된 트래커의 사용자 이름을 바꾸려면 아래 명령어를 실행하세요.
"새 이름" 부분만 본인 이름으로 바꾸면 됩니다.

cd ~/.agent-usage-tracker && python3 track_agent_usage.py --name "새 이름" --once

터미널에서 사용량 확인

웹 대시보드 접속 없이도 현재 계정의 토큰 사용량을
터미널에서 바로 확인할 수 있습니다.

cd ~/.agent-usage-tracker && python3 track_agent_usage.py --report

사용 순서

1. 작업 중인 프로젝트에서 VSCode 터미널을 엽니다.

2. 위 설치 명령어를 한 번 실행하고 이름을 입력합니다.

3. 다음부터는 재실행 명령어만 입력해 트래커를 켭니다.

4. 이름을 바꾸고 싶을 때는 이름 변경 명령을 실행합니다.

5. 사용량은 터미널 또는 대시보드에서 확인합니다.

확인 방법

트래커가 실행되면 AI 에이전트가 로컬에 남긴 로그 파일을 읽고
토큰 사용량 변화를 기록한 뒤 10분 간격으로 대시보드에 반영됩니다.