stats

name	stats
description	code-forge 사용량 통계. ~/.code-forge/usage.jsonl을 파싱하여 에이전트/스킬 사용 빈도 top 5와 요약을 터미널에 출력.
category	utility
user-invocable	false

/stats — Bellows 사용량 통계

usage.jsonl 로그를 분석하여 에이전트/스킬 사용 통계를 보여준다.

[즉시 실행] 아래 절차를 따라 통계를 출력하세요.

입력: $ARGUMENTS

---

옵션

옵션	설명	예시
(없음)	전체 통계	/stats
--week	최근 7일	/stats --week
--month	최근 30일	/stats --month
--project	현재 프로젝트만	/stats --project

---

실행 절차

Step 1: 로그 파일 확인

LOG_FILE="$HOME/.code-forge/usage.jsonl"

파일이 없으면:

사용 기록이 없습니다. 에이전트나 스킬을 사용하면 자동으로 기록됩니다.

Step 2: 통계 파싱

Bash로 usage.jsonl을 파싱한다.

기간 필터링:

• --week: 최근 7일의 타임스탬프만 필터
• --month: 최근 30일
• --project: "project":"현재디렉토리명"만 필터
• (없음): 전체

파싱 방법:

jq가 있으면 jq 사용:

# 에이전트 Top 5
jq -r 'select(.type=="agent") | .name' "$LOG_FILE" | sort | uniq -c | sort -rn | head -5

# 스킬 Top 5
jq -r 'select(.type=="skill") | .name' "$LOG_FILE" | sort | uniq -c | sort -rn | head -5

jq 없으면 grep/awk 폴백:

# 에이전트 Top 5
grep '"type":"agent"' "$LOG_FILE" | grep -o '"name":"[^"]*"' | sed 's/"name":"//;s/"//' | sort | uniq -c | sort -rn | head -5

# 스킬 Top 5
grep '"type":"skill"' "$LOG_FILE" | grep -o '"name":"[^"]*"' | sed 's/"name":"//;s/"//' | sort | uniq -c | sort -rn | head -5

Step 3: 출력 형식

## code-forge 사용 통계

**기간:** {시작일} ~ {종료일} ({총 N일})
**총 호출:** {총 횟수}회

### 에이전트 Top 5
| # | 에이전트 | 호출 | 비율 |
|---|---------|------|------|
| 1 | {name} | {count} | {%} |
| 2 | {name} | {count} | {%} |
| 3 | {name} | {count} | {%} |
| 4 | {name} | {count} | {%} |
| 5 | {name} | {count} | {%} |

### 스킬 Top 5
| # | 스킬 | 호출 | 비율 |
|---|------|------|------|
| 1 | {name} | {count} | {%} |
| 2 | {name} | {count} | {%} |
| 3 | {name} | {count} | {%} |
| 4 | {name} | {count} | {%} |
| 5 | {name} | {count} | {%} |

### 프로젝트별
| 프로젝트 | 에이전트 | 스킬 | 합계 |
|---------|---------|------|------|
| {name} | {count} | {count} | {total} |

### 일별 추이 (최근 7일)
{날짜}: {"█" * count} {count}

데이터가 적으면 (10건 미만) 간략 형식으로:

## code-forge 사용 통계

총 {N}회 사용 ({에이전트 X회, 스킬 Y회})

가장 많이 사용: {name} ({count}회)