tokmon 0.5.0 → 0.5.2

package/README.md

@@ -1,31 +1,10 @@
 # tokmon
 
-Terminal dashboard for Claude Code usage and costs. Tabbed interface with auto-refresh.
+Terminal dashboard for Claude Code usage, costs, and rate limits.
 
 Built with [Ink](https://github.com/vadimdemedes/ink), TypeScript.
 
-```
-  ◉ tokmon  ·  2s                                              01:17:09 AM
-
-   Dashboard   Daily    ←→ or 1-2
-
-  ┃ Claude
-  ┃
-  ┃ Today              $166.10     252.7M tokens
-  ┃ This Week          $399.79     608.2M tokens
-  ┃ This Month        $1337.03       2.2B tokens
-
-  ┃ Active Block  12m remaining
-  ┃
-  ┃ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━─ 96%
-  ┃
-  ┃ $314.37 spent  ·  ~$328.01 proj  ·  $65.60/hr
-
-  ──────────────────────────────────────────────────
-  Total $1337.03
-
-  by David Ilie (davidilie.com)
-```
+![tokmon dashboard](screenshot.png)
 
 ## Quick Start
 
@@ -45,7 +24,7 @@ pnpm dlx tokmon
 npm install -g tokmon
 ```
 
-Then just run `tokmon`. Press `Ctrl+C` to exit.
+Then just run `tokmon`. Press `q` to quit.
 
 ## Options
 
@@ -54,45 +33,65 @@ Then just run `tokmon`. Press `Ctrl+C` to exit.
 -h, --help                Show help
 ```
 
-```bash
-tokmon -i 5    # refresh every 5 seconds
-```
+## Keybindings
 
-## Views
+| Key | Action |
+|-----|--------|
+| `Tab` / `←→` | Switch between Dashboard and Table |
+| `1` `2` | Jump to view |
+| `d` `w` `m` | Daily / Weekly / Monthly (in Table view) |
+| `↑` `↓` | Scroll table |
+| `PgUp` `PgDn` | Scroll table fast |
+| `s` | Settings |
+| `q` | Quit |
 
-Navigate between views with `←` `→` arrow keys, `Tab`, or number keys `1` `2`.
+## Views
 
 | View | Description |
 |------|-------------|
-| **Dashboard** | Today / week / month cost summaries, active 5-hour block with burn rate |
-| **Daily** | Per-day breakdown table with model, token, and cost columns (scrollable with `↑` `↓`) |
+| **Dashboard** | Today / week / month cost summaries, burn rate ($/hr), real-time rate limits with reset countdowns |
+| **Table → Daily** | Per-day breakdown with models, tokens, and costs (6 months of history) |
+| **Table → Weekly** | Grouped by ISO week |
+| **Table → Monthly** | Grouped by month |
+
+## Rate Limits
+
+Fetches real billing data from Anthropic's OAuth API (reads your token from macOS Keychain automatically). Shows:
+
+- **Session** — 5-hour utilization with reset countdown
+- **Weekly** — 7-day utilization with reset countdown
+- **Sonnet** — Sonnet-specific limits (if applicable)
+- **Extra usage** — spend vs monthly limit
+
+Polls every 2 minutes to stay within API rate limits.
+
+## Settings
+
+Press `s` to open settings. Persisted to `~/.config/tokmon/config.json` (macOS/Linux) or `%APPDATA%\tokmon\config.json` (Windows).
+
+- **Refresh interval** — adjust with `←→`
+- **Clear screen** — on/off toggle
 
 ## How It Works
 
-Reads Claude Code's JSONL session logs directly from `~/.claude/projects/`. Calculates costs using Claude model pricing (Opus, Sonnet, Haiku). Caches file reads by mtime so subsequent refreshes are near-instant.
+Reads Claude Code's JSONL session logs directly from `~/.claude/projects/`. Calculates costs using Claude model pricing (Opus, Sonnet, Haiku). Caches file reads by mtime so refreshes are near-instant.
+
+Dashboard loads current month only (fast). Table loads 6 months lazily on first switch.
 
 Cross-platform: supports macOS, Linux, and Windows (`%APPDATA%`, `XDG_CONFIG_HOME`, `CLAUDE_CONFIG_DIR`).
 
 ## CI/CD
 
-Publishes to npm automatically via GitHub Actions when a version tag is pushed:
+Publishes to npm via GitHub Actions on version tags:
 
 ```bash
-git tag v0.2.0 && git push --tags
+git tag v0.5.0 && git push --tags
 ```
 
 ## Requirements
 
 - Node.js 20+
-- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (generates usage data in `~/.claude/projects/`)
-
-## Tech Stack
-
-| Tool | Purpose |
-|------|---------|
-| Ink 5 | React terminal UI |
-| TypeScript 5.7+ | Strict mode |
-| tsup | Build |
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
 
 ## Author
 

package/dist/cli.js

@@ -198,11 +198,20 @@ async function fetchDashboard() {
   const todayStart = new Date(d.getFullYear(), d.getMonth(), d.getDate()).getTime();
   const weekDay = d.getDay();
   const weekStart = new Date(d.getFullYear(), d.getMonth(), d.getDate() - (weekDay === 0 ? 6 : weekDay - 1)).getTime();
+  const now = Date.now();
   const entries = await loadEntries(monthStart);
+  const todayEntries = entries.filter((e) => e.ts >= todayStart);
+  let burnRate = 0;
+  if (todayEntries.length > 0) {
+    const oldest = Math.min(...todayEntries.map((e) => e.ts));
+    const hrs = (now - oldest) / 36e5;
+    if (hrs > 0) burnRate = todayEntries.reduce((s, e) => s + e.cost, 0) / hrs;
+  }
   return {
-    today: sum(entries.filter((e) => e.ts >= todayStart)),
+    today: sum(todayEntries),
     week: sum(entries.filter((e) => e.ts >= weekStart)),
-    month: sum(entries.filter((e) => e.ts >= monthStart))
+    month: sum(entries.filter((e) => e.ts >= monthStart)),
+    burnRate
   };
 }
 async function fetchTable() {
@@ -615,7 +624,15 @@ function DashboardView({ data, billing }) {
           /* @__PURE__ */ jsx(Box, { height: 1 }),
           /* @__PURE__ */ jsx(SummaryRow, { label: "Today", summary: data.today }),
           /* @__PURE__ */ jsx(SummaryRow, { label: "This Week", summary: data.week }),
-          /* @__PURE__ */ jsx(SummaryRow, { label: "This Month", summary: data.month })
+          /* @__PURE__ */ jsx(SummaryRow, { label: "This Month", summary: data.month }),
+          data.burnRate > 0 && /* @__PURE__ */ jsxs(Fragment, { children: [
+            /* @__PURE__ */ jsx(Box, { height: 1 }),
+            /* @__PURE__ */ jsxs(Box, { children: [
+              /* @__PURE__ */ jsx(Box, { width: 14, children: /* @__PURE__ */ jsx(Text, { dimColor: true, children: "Burn rate" }) }),
+              /* @__PURE__ */ jsx(Box, { width: 12, justifyContent: "flex-end", children: /* @__PURE__ */ jsx(Text, { color: "red", children: currency(data.burnRate) }) }),
+              /* @__PURE__ */ jsx(Text, { dimColor: true, children: "/hr" })
+            ] })
+          ] })
         ]
       }
     ),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokmon",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Terminal dashboard for Claude Code usage and costs",
   "type": "module",
   "bin": {