Show usage analytics dashboard - command invocations, skill activations, agent spawns. Supports --export json/csv and --since filtering. Activates for analytics, usage stats, command stats, what commands used, skill usage, agent usage.
View usage analytics dashboard showing command invocations, skill activations, and agent spawns. Filter by date range, type, or plugin, and export results to JSON or CSV.
/plugin marketplace add anton-abyzov/specweave/plugin install sw@specweaveShow SpecWeave usage statistics and analytics.
/sw:analytics [OPTIONS]
| Option | Description | Default |
|---|---|---|
--since DATE | Start date (YYYY-MM-DD or ISO 8601) | 30 days ago |
--until DATE | End date | Now |
--export FORMAT | Export to json or csv | None |
--limit N | Number of items in top lists | 10 |
--type TYPE | Filter by type (command/skill/agent) | All |
--plugin NAME | Filter by plugin | All |
# Show dashboard (last 30 days)
/sw:analytics
# Last 7 days
/sw:analytics --since 2025-12-23
# Export to JSON
/sw:analytics --export json
# Export to CSV with date range
/sw:analytics --since 2025-12-01 --until 2025-12-31 --export csv
# Show only commands
/sw:analytics --type command
# Filter by plugin
/sw:analytics --plugin specweave-github
š SpecWeave Usage Analytics
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
Period: 2025-12-01 to 2025-12-30
Total Events: 1,234 | Success Rate: 98.5%
TOP COMMANDS Count Success Avg(ms)
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
1. /sw:do ............................ 156 98% 2,340
2. /sw:increment ..................... 89 100% 4,520
3. /sw:progress ...................... 67 100% 180
4. /sw:done .......................... 34 97% 890
5. /sw:validate ...................... 28 96% 1,200
TOP SKILLS Count Success Plugin
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
1. increment-planner ................. 45 100% specweave
2. spec-generator .................... 34 98% specweave
3. qa-engineer ....................... 28 100% specweave-testing
TOP AGENTS Count Success Plugin
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
1. architect ......................... 23 100% specweave
2. frontend-architect ................ 18 100% specweave-frontend
3. qa-engineer ....................... 15 100% specweave-testing
ACTIVITY (last 7 days)
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
Mon: āāāāāāāāāā 34
Tue: āāāāāāāāāā 45
Wed: āāāāāāāāāā 28
Thu: āāāāāāāāāā 36
Fri: āāāāāāāāāā 21
Sat: āāāāāāāāāā 12
Sun: āāāāāāāāāā 15
When this command is invoked, the agent should:
Parse arguments:
# Extract options
SINCE=$(echo "$ARGS" | grep -oP '(?<=--since\s)[^\s]+' || echo "")
UNTIL=$(echo "$ARGS" | grep -oP '(?<=--until\s)[^\s]+' || echo "")
EXPORT=$(echo "$ARGS" | grep -oP '(?<=--export\s)(json|csv)' || echo "")
LIMIT=$(echo "$ARGS" | grep -oP '(?<=--limit\s)\d+' || echo "10")
TYPE=$(echo "$ARGS" | grep -oP '(?<=--type\s)(command|skill|agent)' || echo "")
PLUGIN=$(echo "$ARGS" | grep -oP '(?<=--plugin\s)[^\s]+' || echo "")
Read analytics data:
.specweave/state/analytics/events.jsonlAggregate statistics:
Display or export:
--export: Write to .specweave/state/analytics/exports/| Source | Location |
|---|---|
| Events log | .specweave/state/analytics/events.jsonl |
| Daily summary | .specweave/state/analytics/daily-summary.json |
| Cache | .specweave/state/analytics/cache.json |
| Exports | .specweave/state/analytics/exports/ |
interface AnalyticsEvent {
timestamp: string; // ISO 8601
type: 'command' | 'skill' | 'agent';
name: string;
plugin?: string;
increment?: string;
duration?: number; // milliseconds
success: boolean;
error?: string;
metadata?: Record<string, unknown>;
}
| Command | Purpose |
|---|---|
/sw:status | Show increment status |
/sw:progress | Show task progress |
/sw:jobs | Show background jobs |