ccusage 0.1.2 → 0.1.4
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 +19 -13
- package/dist/index.js +4 -5
- package/docs/screenshot.png +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -12,6 +12,12 @@ A CLI tool for analyzing Claude Code usage from local JSONL files.
|
|
|
12
12
|
|
|
13
13
|
Inspired by [this article](https://note.com/milliondev/n/n1d018da2d769) about tracking Claude Code usage costs.
|
|
14
14
|
|
|
15
|
+
## Motivation
|
|
16
|
+
|
|
17
|
+
Claude Code's Max plan offers unlimited usage - but wouldn't it be interesting to know how much you'd be paying if you were on a pay-per-use plan?
|
|
18
|
+
|
|
19
|
+
This tool helps you understand the value you're getting from your subscription by calculating the equivalent costs of your actual usage. See how much you're saving and enjoy that satisfying feeling of getting great value! 😊
|
|
20
|
+
|
|
15
21
|
## Features
|
|
16
22
|
|
|
17
23
|
- 📊 **Daily Report**: View token usage and costs aggregated by date
|
|
@@ -30,10 +36,10 @@ Run directly without installation:
|
|
|
30
36
|
|
|
31
37
|
```bash
|
|
32
38
|
# Using npx
|
|
33
|
-
npx ccusage@latest
|
|
39
|
+
npx ccusage@latest daily
|
|
34
40
|
|
|
35
41
|
# Using bunx
|
|
36
|
-
bunx ccusage
|
|
42
|
+
bunx ccusage daily
|
|
37
43
|
```
|
|
38
44
|
|
|
39
45
|
### Local Installation
|
|
@@ -46,7 +52,7 @@ npm install -g ccusage
|
|
|
46
52
|
bun install -g ccusage
|
|
47
53
|
|
|
48
54
|
# Then run
|
|
49
|
-
ccusage
|
|
55
|
+
ccusage daily
|
|
50
56
|
```
|
|
51
57
|
|
|
52
58
|
### Development Setup
|
|
@@ -71,18 +77,18 @@ Shows token usage and costs aggregated by date:
|
|
|
71
77
|
|
|
72
78
|
```bash
|
|
73
79
|
# Show all daily usage
|
|
74
|
-
ccusage
|
|
75
|
-
# or: npx ccusage@latest
|
|
76
|
-
# or: bunx ccusage
|
|
80
|
+
ccusage daily
|
|
81
|
+
# or: npx ccusage@latest daily
|
|
82
|
+
# or: bunx ccusage daily
|
|
77
83
|
|
|
78
84
|
# Filter by date range
|
|
79
|
-
ccusage
|
|
85
|
+
ccusage daily --since 20250525 --until 20250530
|
|
80
86
|
|
|
81
87
|
# Use custom Claude data directory
|
|
82
|
-
ccusage
|
|
88
|
+
ccusage daily --path /custom/path/to/.claude
|
|
83
89
|
|
|
84
90
|
# Output in JSON format
|
|
85
|
-
ccusage
|
|
91
|
+
ccusage daily --json
|
|
86
92
|
```
|
|
87
93
|
|
|
88
94
|
### Session Report
|
|
@@ -91,16 +97,16 @@ Shows usage grouped by conversation sessions, sorted by cost:
|
|
|
91
97
|
|
|
92
98
|
```bash
|
|
93
99
|
# Show all sessions
|
|
94
|
-
ccusage
|
|
100
|
+
ccusage session
|
|
95
101
|
|
|
96
102
|
# Filter sessions by last activity date
|
|
97
|
-
ccusage
|
|
103
|
+
ccusage session --since 20250525
|
|
98
104
|
|
|
99
105
|
# Combine filters
|
|
100
|
-
ccusage
|
|
106
|
+
ccusage session --since 20250525 --until 20250530 --path /custom/path
|
|
101
107
|
|
|
102
108
|
# Output in JSON format
|
|
103
|
-
ccusage
|
|
109
|
+
ccusage session --json
|
|
104
110
|
```
|
|
105
111
|
|
|
106
112
|
### Options
|
package/dist/index.js
CHANGED
|
@@ -5754,10 +5754,9 @@ const SessionUsageSchema = object({
|
|
|
5754
5754
|
});
|
|
5755
5755
|
const formatDate = (dateStr) => {
|
|
5756
5756
|
const date = new Date(dateStr);
|
|
5757
|
-
const
|
|
5758
|
-
const
|
|
5759
|
-
const
|
|
5760
|
-
const day = String(offsetDate.getUTCDate()).padStart(2, "0");
|
|
5757
|
+
const year = date.getFullYear();
|
|
5758
|
+
const month = String(date.getMonth() + 1).padStart(2, "0");
|
|
5759
|
+
const day = String(date.getDate()).padStart(2, "0");
|
|
5761
5760
|
return `${year}-${month}-${day}`;
|
|
5762
5761
|
};
|
|
5763
5762
|
async function loadUsageData(options) {
|
|
@@ -6817,7 +6816,7 @@ const consola = createConsola();
|
|
|
6817
6816
|
//#endregion
|
|
6818
6817
|
//#region package.json
|
|
6819
6818
|
var name = "ccusage";
|
|
6820
|
-
var version = "0.1.
|
|
6819
|
+
var version = "0.1.4";
|
|
6821
6820
|
var description = "Usage analysis tool for Claude Code";
|
|
6822
6821
|
|
|
6823
6822
|
//#endregion
|
package/docs/screenshot.png
CHANGED
|
Binary file
|