You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 18ea04f
Browse filesBrowse the repository at this point in the historyBrowse files
Add Hermes Agent to the README, guide navigation, source overview pages, environment variable reference, and configuration namespace documentation.
Document the local state.db location, HERMES_HOME override, focused commands, token and cost behavior, and troubleshooting guidance for users without requiring local Hermes data in tests.
Copy file name to clipboardExpand all lines: apps/ccusage/README.md
+3-2Lines changed: 3 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,7 +25,7 @@
25
25
26
26
## Supported Sources
27
27
28
-
The main CLI tool for analyzing Claude Code, Codex, OpenCode, Amp, and pi-agent usage from local data. Track daily, weekly, monthly, and session-based usage with beautiful tables.
28
+
The main CLI tool for analyzing Claude Code, Codex, OpenCode, Amp, pi-agent, and Hermes Agent usage from local data. Track daily, weekly, monthly, and session-based usage with beautiful tables.
29
29
30
30
## Installation
31
31
@@ -64,6 +64,7 @@ bunx ccusage codex daily --speed fast
64
64
bunx ccusage opencode weekly
65
65
bunx ccusage amp session
66
66
bunx ccusage pi daily --pi-path /path/to/sessions
67
+
bunx ccusage hermes daily
67
68
bunx ccusage pi daily --pi-path /path/to/sessions,/archive/pi/sessions
Copy file name to clipboardExpand all lines: docs/guide/all-reports.md
+10-8Lines changed: 10 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,7 +25,7 @@ ccusage daily --all
25
25
26
26
## How Unified Views Work
27
27
28
-
ccusage detects local usage files from Claude Code, Codex, OpenCode, Amp, and pi-agent. The same daily, weekly, monthly, and session views can run in two modes:
28
+
ccusage detects local usage files from Claude Code, Codex, OpenCode, Amp, pi-agent, and Hermes Agent. The same daily, weekly, monthly, and session views can run in two modes:
@@ -218,6 +225,7 @@ This configuration affects source-focused commands such as:
218
225
ccusage codex daily
219
226
ccusage opencode weekly
220
227
ccusage pi daily
228
+
ccusage hermes daily
221
229
```
222
230
223
231
Source-specific settings are also applied when running unified reports such as `ccusage daily`. In that case, each source receives its own merged options before data is loaded.
Copy file name to clipboardExpand all lines: docs/guide/environment-variables.md
+10-8Lines changed: 10 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,13 +6,14 @@ ccusage supports several environment variables for configuration and customizati
6
6
7
7
ccusage detects supported data source files from conventional locations by default. Set these variables when your data lives somewhere else. Each value can be one directory or a comma-separated list of directories:
> Hermes Agent support is experimental. Expect changes while both ccusage and [Hermes Agent](https://github.com/NousResearch/hermes-agent) continue to evolve.
4
+
5
+
ccusage can read Hermes Agent session usage from its local SQLite state database. The adapter uses the same focused and unified report shape as the other local coding CLI data sources.
6
+
7
+
## Focused Views
8
+
9
+
::: code-group
10
+
11
+
```bash [bunx (Recommended)]
12
+
bunx ccusage hermes --help
13
+
```
14
+
15
+
```bash [npx]
16
+
npx ccusage@latest hermes --help
17
+
```
18
+
19
+
```bash [pnpm]
20
+
pnpm dlx ccusage hermes --help
21
+
```
22
+
23
+
:::
24
+
25
+
## Data Source
26
+
27
+
The CLI reads Hermes Agent session rows from `$HERMES_HOME/state.db`. When `HERMES_HOME` is not set, ccusage checks `~/.hermes/state.db`.
Ensure the database exists at `$HERMES_HOME/state.db` or `~/.hermes/state.db`. If your database lives elsewhere, set `HERMES_HOME` to the directory that contains `state.db`.
66
+
:::
67
+
68
+
::: details Costs showing as $0.00
69
+
If Hermes has no recorded cost and a model is not in LiteLLM's database, the calculated cost will be $0.00.
Copy file name to clipboardExpand all lines: docs/guide/index.md
+12-10Lines changed: 12 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,9 +2,9 @@
2
2
3
3

4
4
5
-
**ccusage** is a local CLI for understanding coding (agent) CLI token usage and estimated costs across Claude Code, Codex, OpenCode, Amp, and pi-agent.
5
+
**ccusage** is a local CLI for understanding coding (agent) CLI token usage and estimated costs across Claude Code, Codex, OpenCode, Amp, pi-agent, and Hermes Agent.
6
6
7
-
The original **“cc”** came from **C**laude **C**ode usage and now also fits **C**odex **C**LI usage. As OpenCode, Amp, pi-agent, and other coding (agent) CLIs became part of the same workflow, ccusage expanded into a general name for local coding CLI usage analysis.
7
+
The original **“cc”** came from **C**laude **C**ode usage and now also fits **C**odex **C**LI usage. As OpenCode, Amp, pi-agent, Hermes Agent, and other coding (agent) CLIs became part of the same workflow, ccusage expanded into a general name for local coding CLI usage analysis.
8
8
9
9
## The Problem
10
10
@@ -19,7 +19,7 @@ Modern coding (agent) CLI usage is split across several local data formats. That
19
19
20
20
ccusage reads the local usage files that coding CLIs already generate and provides:
21
21
22
-
-**All Sources by Default** - Claude Code, Codex, OpenCode, Amp, and pi-agent in one CLI
22
+
-**All Sources by Default** - Claude Code, Codex, OpenCode, Amp, pi-agent, and Hermes Agent in one CLI
23
23
-**Usage Views** - Daily, weekly, monthly, and session-based breakdowns
24
24
-**Cost Analysis** - Estimated costs based on token usage and model pricing
25
25
-**Focused Data Source Views** - Start with all detected sources, then narrow the same usage views to one source when needed
@@ -72,13 +72,14 @@ Each data source page covers the details that only apply to that source, includi
72
72
73
73
ccusage reads from local coding CLI data directories:
The tool automatically detects available data and aggregates all supported coding CLIs by default.
84
85
Each source-specific environment variable can also contain comma-separated directories, which lets unified reports combine current profiles and archives.
@@ -102,6 +103,7 @@ ccusage codex daily --speed fast
102
103
ccusage opencode weekly
103
104
ccusage amp session
104
105
ccusage pi monthly
106
+
ccusage hermes daily
105
107
```
106
108
107
109
Use `ccusage <source> <report>` only when you want to narrow a report to one source.
0 commit comments