toktrack 0.1.18 → 0.1.20
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.
- package/README.md +29 -37
- package/bin/toktrack-darwin-arm64 +0 -0
- package/bin/toktrack-darwin-x64 +0 -0
- package/bin/toktrack-linux-arm64 +0 -0
- package/bin/toktrack-linux-x64 +0 -0
- package/bin/toktrack-win32-x64.exe +0 -0
- package/package.json +1 -2
package/README.md
CHANGED
|
@@ -1,17 +1,15 @@
|
|
|
1
1
|
# toktrack
|
|
2
2
|
|
|
3
|
+
[](https://github.com/mag123c/toktrack/actions/workflows/ci.yml)
|
|
4
|
+
[](https://crates.io/crates/toktrack)
|
|
5
|
+
[](https://www.npmjs.com/package/toktrack)
|
|
3
6
|
[](https://github.com/mag123c/toktrack/blob/main/LICENSE)
|
|
4
7
|
|
|
5
8
|
Ultra-fast AI CLI token usage tracker. Built with Rust + simd-json + ratatui.
|
|
6
9
|
|
|
7
10
|

|
|
8
11
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
| Tool | Time (2,000+ files / 3GB) | |
|
|
12
|
-
|------|---------------------------|---|
|
|
13
|
-
| ccusage (Node.js) | ~43s | 1x |
|
|
14
|
-
| **toktrack (Rust)** | **~3s** | **15x faster** |
|
|
12
|
+
> Scanning 2,000+ session files (3 GB) took over 40 seconds with existing tools — toktrack does it in ~1 second.
|
|
15
13
|
|
|
16
14
|
## Installation
|
|
17
15
|
|
|
@@ -25,11 +23,11 @@ npm install -g toktrack
|
|
|
25
23
|
|
|
26
24
|
## Features
|
|
27
25
|
|
|
28
|
-
- **
|
|
29
|
-
- **TUI Dashboard**
|
|
30
|
-
- **Multi-CLI Support**
|
|
31
|
-
- **CLI Commands**
|
|
32
|
-
- **
|
|
26
|
+
- **Ultra-Fast Parsing** — simd-json + rayon parallel processing (~2 GiB/s throughput)
|
|
27
|
+
- **TUI Dashboard** — 4 views (Overview, Models, Daily, Stats) with daily/weekly/monthly breakdown
|
|
28
|
+
- **Multi-CLI Support** — Claude Code, Codex CLI, Gemini CLI
|
|
29
|
+
- **CLI Commands** — `daily`, `weekly`, `monthly`, `stats` with JSON output
|
|
30
|
+
- **Data Preservation** — Cached daily summaries survive CLI data deletion
|
|
33
31
|
|
|
34
32
|
## Supported AI CLIs
|
|
35
33
|
|
|
@@ -39,46 +37,40 @@ npm install -g toktrack
|
|
|
39
37
|
| Codex CLI | `~/.codex/sessions/` |
|
|
40
38
|
| Gemini CLI | `~/.gemini/tmp/*/chats/` |
|
|
41
39
|
|
|
42
|
-
##
|
|
43
|
-
|
|
44
|
-
### TUI Mode (Default)
|
|
40
|
+
## Supported Platforms
|
|
45
41
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
42
|
+
| Platform | Architecture |
|
|
43
|
+
|----------|-------------|
|
|
44
|
+
| macOS | x64, ARM64 |
|
|
45
|
+
| Linux | x64, ARM64 |
|
|
46
|
+
| Windows | x64 |
|
|
49
47
|
|
|
50
|
-
|
|
48
|
+
## Quick Usage
|
|
51
49
|
|
|
52
50
|
```bash
|
|
53
|
-
|
|
54
|
-
toktrack
|
|
51
|
+
# Launch TUI dashboard
|
|
52
|
+
npx toktrack
|
|
55
53
|
|
|
56
|
-
|
|
57
|
-
toktrack
|
|
54
|
+
# JSON output for scripting
|
|
55
|
+
npx toktrack daily --json
|
|
56
|
+
npx toktrack stats --json
|
|
58
57
|
```
|
|
59
58
|
|
|
60
|
-
### Keyboard Shortcuts
|
|
61
|
-
|
|
62
|
-
| Key | Action |
|
|
63
|
-
|-----|--------|
|
|
64
|
-
| `1-4` | Switch tabs |
|
|
65
|
-
| `Tab` | Next tab |
|
|
66
|
-
| `j/k` or `↑/↓` | Scroll |
|
|
67
|
-
| `d/w/m` | Daily / Weekly / Monthly view (Daily tab) |
|
|
68
|
-
| `?` | Help |
|
|
69
|
-
| `q` | Quit |
|
|
70
|
-
|
|
71
59
|
## Performance
|
|
72
60
|
|
|
73
|
-
|
|
|
74
|
-
|
|
75
|
-
|
|
|
76
|
-
|
|
|
61
|
+
| Mode | Time |
|
|
62
|
+
|------|------|
|
|
63
|
+
| Cold start (no cache) | **~1.2s** |
|
|
64
|
+
| Warm start (cached) | **~0.05s** |
|
|
65
|
+
|
|
66
|
+
> Measured on Apple Silicon (9,000+ files / 3.4 GB).
|
|
77
67
|
|
|
78
68
|
## Links
|
|
79
69
|
|
|
80
70
|
- [GitHub](https://github.com/mag123c/toktrack)
|
|
71
|
+
- [Documentation](https://github.com/mag123c/toktrack#readme)
|
|
81
72
|
- [Releases](https://github.com/mag123c/toktrack/releases)
|
|
73
|
+
- [Changelog](https://github.com/mag123c/toktrack/blob/main/CHANGELOG.md)
|
|
82
74
|
|
|
83
75
|
## License
|
|
84
76
|
|
|
Binary file
|
package/bin/toktrack-darwin-x64
CHANGED
|
Binary file
|
package/bin/toktrack-linux-arm64
CHANGED
|
Binary file
|
package/bin/toktrack-linux-x64
CHANGED
|
Binary file
|
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "toktrack",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.20",
|
|
4
4
|
"description": "Ultra-fast AI CLI token usage tracker",
|
|
5
5
|
"bin": {
|
|
6
6
|
"toktrack": "./bin/run.js"
|
|
@@ -39,7 +39,6 @@
|
|
|
39
39
|
"gemini-cli",
|
|
40
40
|
"cursor",
|
|
41
41
|
"opencode",
|
|
42
|
-
"ccusage",
|
|
43
42
|
"tokscale",
|
|
44
43
|
"ai-cost",
|
|
45
44
|
"ai-billing",
|