@rajbos/ai-engineering-fluency 0.0.2 → 0.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +11 -81
  2. package/dist/cli.js +53 -44
  3. package/package.json +10 -9
package/README.md CHANGED
@@ -1,92 +1,22 @@
1
1
  # Copilot Token Tracker CLI
2
2
 
3
- Command-line interface for analyzing GitHub Copilot token usage from local session files. Works anywhere Copilot Chat stores its session data.
3
+ ![AI Engineering Fluency](../assets/AI%20Engineering%20Fluency%20-%20Transparent.png)
4
4
 
5
- ## Quick Start
5
+ > For user-facing documentation and command examples, see [docs/cli/README.md](../docs/cli/README.md).
6
6
 
7
- ```bash
8
- # Run directly with npx (no install required)
9
- npx copilot-token-tracker-cli stats
10
-
11
- # Or install globally
12
- npm install -g copilot-token-tracker-cli
13
- copilot-token-tracker stats
14
- ```
15
-
16
- ## Commands
17
-
18
- ### `stats` - Session Overview
19
-
20
- Show discovered session files, sessions, chat turns, and token counts.
21
-
22
- ```bash
23
- copilot-token-tracker stats
24
- copilot-token-tracker stats --verbose # Show per-folder breakdown
25
- ```
26
-
27
- ![Terminal Statistics](../docs/images/Terminal%20Statistics.png)
28
-
29
- ### `usage` - Token Usage Report
30
-
31
- Show token usage broken down by time period.
32
-
33
- ```bash
34
- copilot-token-tracker usage
35
- copilot-token-tracker usage --models # Show per-model breakdown
36
- copilot-token-tracker usage --cost # Show estimated cost
37
- ```
38
-
39
- ![Terminal Usage](../docs/images/Terminal%20Usage.png)
40
-
41
- ### `environmental` - Environmental Impact
42
-
43
- Show environmental impact of your Copilot usage (COâ‚‚ emissions, water usage, tree equivalents).
44
-
45
- ```bash
46
- copilot-token-tracker environmental
47
- copilot-token-tracker env # Short alias
48
- ```
49
-
50
- ### `fluency` - Fluency Score
51
-
52
- Show your Copilot Fluency Score across multiple categories (Prompt Engineering, Context Engineering, Agentic, Tool Usage, Customization, Team Collaboration).
53
-
54
- ```bash
55
- copilot-token-tracker fluency
56
- copilot-token-tracker fluency --tips # Show improvement tips, if there are any
57
- ```
58
-
59
- ### `diagnostics` - Search Locations & Stats
60
-
61
- Show all locations searched for session files, whether each path exists, and per-location stats (files, sessions, chat turns, tokens).
62
-
63
- ```bash
64
- copilot-token-tracker diagnostics
65
- ```
66
-
67
- ![Terminal Diagnostics](../docs/images/Terminal%20Diagnostitcs.png)
68
-
69
- ## Data Sources
70
-
71
- The CLI scans the same session files that the [Copilot Token Tracker VS Code extension](https://marketplace.visualstudio.com/items?itemName=RobBos.copilot-token-tracker) uses:
72
-
73
- - **VS Code** (Stable, Insiders, Exploration) workspace and global storage
74
- - **VSCodium** and **Cursor** editor sessions
75
- - **VS Code Remote** / Codespaces sessions
76
- - **Copilot CLI** agent mode sessions
77
- - **OpenCode** sessions (JSON and SQLite)
7
+ 📦 **npm**: [@rajbos/ai-engineering-fluency](https://www.npmjs.com/package/@rajbos/ai-engineering-fluency)
78
8
 
79
9
  ## Development
80
10
 
81
11
  ```bash
82
12
  # From the repository root
83
- npm run cli:build # Build the CLI
84
- npm run cli:stats # Run stats command
85
- npm run cli:usage # Run usage command
86
- npm run cli:environmental # Run environmental command
87
- npm run cli:fluency # Run fluency command
88
- npm run cli:diagnostics # Run diagnostics command
89
- npm run cli -- --help # Run any CLI command
13
+ npm run cli:build # Build the CLI
14
+ npm run cli:stats # Run stats command
15
+ npm run cli:usage # Run usage command
16
+ npm run cli:environmental # Run environmental command
17
+ npm run cli:fluency # Run fluency command
18
+ npm run cli:diagnostics # Run diagnostics command
19
+ npm run cli -- --help # Run any CLI command
90
20
  ```
91
21
 
92
22
  ## Requirements
@@ -96,4 +26,4 @@ npm run cli -- --help # Run any CLI command
96
26
 
97
27
  ## License
98
28
 
99
- MIT - See [LICENSE](../LICENSE) for details.
29
+ MIT — see [LICENSE](../LICENSE) for details.