toktrack 0.1.18 → 0.1.19
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 +28 -38
- 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,18 +1,14 @@
|
|
|
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
|
-
## Why toktrack?
|
|
10
|
-
|
|
11
|
-
| Tool | Time (2,000+ files / 3GB) | |
|
|
12
|
-
|------|---------------------------|---|
|
|
13
|
-
| ccusage (Node.js) | ~43s | 1x |
|
|
14
|
-
| **toktrack (Rust)** | **~3s** | **15x faster** |
|
|
15
|
-
|
|
16
12
|
## Installation
|
|
17
13
|
|
|
18
14
|
```bash
|
|
@@ -25,11 +21,11 @@ npm install -g toktrack
|
|
|
25
21
|
|
|
26
22
|
## Features
|
|
27
23
|
|
|
28
|
-
- **
|
|
29
|
-
- **TUI Dashboard**
|
|
30
|
-
- **Multi-CLI Support**
|
|
31
|
-
- **CLI Commands**
|
|
32
|
-
- **
|
|
24
|
+
- **Ultra-Fast Parsing** — simd-json + rayon parallel processing (~2 GiB/s throughput)
|
|
25
|
+
- **TUI Dashboard** — 4 views (Overview, Models, Daily, Stats) with daily/weekly/monthly breakdown
|
|
26
|
+
- **Multi-CLI Support** — Claude Code, Codex CLI, Gemini CLI
|
|
27
|
+
- **CLI Commands** — `daily`, `weekly`, `monthly`, `stats` with JSON output
|
|
28
|
+
- **Data Preservation** — Cached daily summaries survive CLI data deletion
|
|
33
29
|
|
|
34
30
|
## Supported AI CLIs
|
|
35
31
|
|
|
@@ -39,46 +35,40 @@ npm install -g toktrack
|
|
|
39
35
|
| Codex CLI | `~/.codex/sessions/` |
|
|
40
36
|
| Gemini CLI | `~/.gemini/tmp/*/chats/` |
|
|
41
37
|
|
|
42
|
-
##
|
|
43
|
-
|
|
44
|
-
### TUI Mode (Default)
|
|
38
|
+
## Supported Platforms
|
|
45
39
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
40
|
+
| Platform | Architecture |
|
|
41
|
+
|----------|-------------|
|
|
42
|
+
| macOS | x64, ARM64 |
|
|
43
|
+
| Linux | x64, ARM64 |
|
|
44
|
+
| Windows | x64 |
|
|
49
45
|
|
|
50
|
-
|
|
46
|
+
## Quick Usage
|
|
51
47
|
|
|
52
48
|
```bash
|
|
53
|
-
|
|
54
|
-
toktrack
|
|
49
|
+
# Launch TUI dashboard
|
|
50
|
+
npx toktrack
|
|
55
51
|
|
|
56
|
-
|
|
57
|
-
toktrack
|
|
52
|
+
# JSON output for scripting
|
|
53
|
+
npx toktrack daily --json
|
|
54
|
+
npx toktrack stats --json
|
|
58
55
|
```
|
|
59
56
|
|
|
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
57
|
## Performance
|
|
72
58
|
|
|
73
|
-
|
|
|
74
|
-
|
|
75
|
-
|
|
|
76
|
-
|
|
|
59
|
+
| Mode | Time |
|
|
60
|
+
|------|------|
|
|
61
|
+
| Cold start (no cache) | **~1.2s** |
|
|
62
|
+
| Warm start (cached) | **~0.05s** |
|
|
63
|
+
|
|
64
|
+
> Measured on Apple Silicon (9,000+ files / 3.4 GB).
|
|
77
65
|
|
|
78
66
|
## Links
|
|
79
67
|
|
|
80
68
|
- [GitHub](https://github.com/mag123c/toktrack)
|
|
69
|
+
- [Documentation](https://github.com/mag123c/toktrack#readme)
|
|
81
70
|
- [Releases](https://github.com/mag123c/toktrack/releases)
|
|
71
|
+
- [Changelog](https://github.com/mag123c/toktrack/blob/main/CHANGELOG.md)
|
|
82
72
|
|
|
83
73
|
## License
|
|
84
74
|
|
|
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.19",
|
|
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",
|