@neuralmindlabs/tokn 0.1.0

package/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+# Ubuntu-only to stay within the free Actions tier on a private repo.
+# The Tauri macOS build is not run in CI (a macOS runner bills at 10x
+# minutes); build it locally with `npm run tauri build`.
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npm run lint
+      - run: npm run test:coverage

package/.oxlintrc.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["react", "typescript", "oxc"],
+  "rules": {
+    "react/rules-of-hooks": "error",
+    "react/only-export-components": ["warn", { "allowConstantExport": true }]
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Suryakant Pandey
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# Tokn
+
+Daily AI token usage and cost across **Claude Code**, **Codex**, and
+**Cursor**, in two forms:
+
+- **[tokn](packages/tokn)** — npm package: `npx tokn` CLI + reusable
+  parsing/pricing core (publish with `npm publish -w tokn`)
+- **Tokn.app** — macOS menu bar app (this repo's root), built on the
+  same `tokn` core
+
+The menu bar shows today's total cost at a glance. Clicking it opens a popover
+with per-tool breakdown and a 14-day trend; "Open dashboard" opens a full
+window with 30/90-day charts, per-model and per-project tables, CSV export,
+and settings.
+
+## How it computes cost
+
+| Source | Method | Meaning |
+|---|---|---|
+| Claude Code | Parses `~/.claude/projects/**/*.jsonl` locally | API-equivalent value (you're on a subscription) |
+| Codex | Parses `~/.codex/sessions/**/*.jsonl` locally | API-equivalent value |
+| Cursor | cursor.com dashboard API (session cookie, set in Settings) | Actual billed dollars |
+
+Pricing comes from LiteLLM's community-maintained price table
+(`src/core/pricing/prices.json`), including Anthropic cache-write (5m at
+1.25x, 1h at 2x input rate) and cache-read rates. Codex token counts are
+derived from deltas of the session-cumulative counter, which is immune to the
+duplicated `token_count` events Codex writes (ccusage double-counts these).
+
+## Connecting Cursor
+
+Cursor keeps usage server-side, so the app needs your dashboard session:
+1. Open [cursor.com/dashboard](https://cursor.com/dashboard) logged in
+2. DevTools → Application → Cookies → copy the value of `WorkosCursorSessionToken`
+3. Paste it in the dashboard's Settings section
+
+The cookie expires every few weeks; the popover shows "reconnect in settings"
+when that happens. Claude/Codex keep working regardless.
+
+## Development
+
+```bash
+npm install
+npx tauri dev        # run the app
+npm test             # unit tests (parsers, pricing, aggregation)
+npm run validate     # cross-check against ccusage + Codex session counters
+npx tauri build      # produce .app / .dmg in src-tauri/target/release/bundle
+```
+
+Architecture: `packages/tokn/` is the published package — pure TypeScript
+parsers, pricing, aggregation (browser-safe `tokn` entry) plus the CLI and
+Node scanner (`tokn/node`). The app's `src/lib/` is Tauri-side glue (fs
+scanning with an incremental per-file cache, refresh loop) and `src-tauri/`
+is the Rust shell (tray icon, popover + dashboard windows).
+
+## Privacy & security
+
+Everything is computed locally: Claude Code and Codex logs never leave your
+machine. The only network calls are to cursor.com (if you connect Cursor) and
+to fetch the pricing table. The Cursor session cookie is stored in plain text
+in the app's local data directory (`~/Library/Application Support/dev.surya.tokn`)
+— treat it like a saved login. The macOS app is menu-bar only and mac-only by
+design; the `tokn` CLI works anywhere Node 20+ runs.
+
+**Nothing sensitive is committed.** The Cursor cookie and cached usage live in
+gitignored store files (`settings.json` / `cache.json`), never in the repo. CI
+runs Ubuntu-only to stay in the free Actions tier — build the macOS app locally.
+
+## License
+
+[MIT](LICENSE)

package/dist/assets/index-Dq74RfU-.css

@@ -0,0 +1 @@
+:root{--sans:-apple-system, BlinkMacSystemFont, "SF Pro Text", system-ui, sans-serif;--mono:ui-monospace, "SF Mono", "JetBrains Mono", Menlo, monospace;font-family:var(--sans);--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light dark;--bg:#f1f1ef;--card:#fff;--text:#18181b;--muted:#6b6b73;--faint:#a6a6ad;--border:#00000017;--hairline:#0000000f;--hover:#00000009;--accent:#6663e6;--accent-soft:#6663e61a;--shadow:0 1px 2px #1414190d, 0 10px 30px #14141912;font-size:13px}@media (prefers-color-scheme:dark){:root{--lightningcss-light: ;--lightningcss-dark:initial}:root:not([data-theme=light]){--lightningcss-light: ;--lightningcss-dark:initial;color-scheme:dark;--bg:#131316;--card:#1c1c20;--text:#e8e8ec;--muted:#8b8b94;--faint:#55555e;--border:#ffffff14;--hairline:#ffffff0e;--hover:#ffffff0a;--accent:#8b87ff;--accent-soft:#8b87ff29;--shadow:0 1px 2px #0000004d, 0 10px 30px #00000061}}:root[data-theme=dark]{--lightningcss-light: ;--lightningcss-dark:initial;color-scheme:dark;--bg:#131316;--card:#1c1c20;--text:#e8e8ec;--muted:#8b8b94;--faint:#55555e;--border:#ffffff14;--hairline:#ffffff0e;--hover:#ffffff0a;--accent:#8b87ff;--accent-soft:#8b87ff29;--shadow:0 1px 2px #0000004d, 0 10px 30px #00000061}:root[data-theme=light]{--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light}*{box-sizing:border-box}html,body,#root{margin:0;padding:0}body{color:var(--text);-webkit-font-smoothing:antialiased;-webkit-user-select:none;user-select:none;background:0 0}.muted{color:var(--muted)}.small{font-size:11px}.right{text-align:right}.big{font-family:var(--mono);letter-spacing:-1px;font-variant-numeric:tabular-nums;font-size:27px;font-weight:600;line-height:1.05}.mid{font-family:var(--mono);letter-spacing:-.4px;font-variant-numeric:tabular-nums;font-size:15px;font-weight:600}.dot{border-radius:2px;flex:none;width:7px;height:7px;display:inline-block}.sc,h2,th{letter-spacing:.9px;text-transform:uppercase;color:var(--muted);font-size:10px;font-weight:600}.popover{background:var(--bg);border:.5px solid var(--border);border-radius:16px;flex-direction:column;gap:8px;height:100vh;padding:8px;display:flex;position:relative;overflow:hidden}.pop-card{background:var(--card);border:.5px solid var(--hairline);border-radius:12px;padding:13px 14px}.pop-hero{padding-bottom:14px}.pop-header{justify-content:space-between;align-items:baseline;display:flex}.pop-tools{flex-direction:column;gap:10px;display:flex}.tool-row{align-items:baseline;gap:8px;display:flex}.tool-row .dot{align-self:center}.tool-name{flex:none;font-weight:500}.leader{border-bottom:1px dotted var(--faint);opacity:.6;flex:1;min-width:12px;transform:translateY(-3px)}.tool-cost{font-family:var(--mono);text-align:right;font-variant-numeric:tabular-nums;letter-spacing:-.3px;min-width:56px;font-weight:600}.pop-chart .small{color:var(--muted)}.bars{align-items:flex-end;gap:3px;height:60px;margin-top:8px;display:flex}.bar-col{flex-direction:column-reverse;flex:1;gap:1px;height:100%;display:flex}.bar-col div{border-radius:2px 2px 0 0}.bar-labels{font-family:var(--mono);font-variant-numeric:tabular-nums;justify-content:space-between;margin-top:5px;display:flex}.pop-footer{justify-content:space-between;align-items:center;margin-top:auto;padding:4px 8px 2px;display:flex}.linkish{color:var(--accent);cursor:pointer;background:0 0;border:none;padding:0;font-size:12px;font-weight:550}.linkish:hover{text-decoration:underline}.dashboard{background:var(--bg);-webkit-user-select:text;user-select:text;min-height:100vh;padding:26px 30px 36px;position:relative}.dash-header{justify-content:space-between;align-items:flex-end;margin-bottom:18px;display:flex}h1{letter-spacing:-.4px;margin:0 0 3px;font-size:21px;font-weight:650}h2{margin:0 0 10px}.controls{gap:6px;display:flex}.seg{background:var(--card);border:.5px solid var(--border);cursor:pointer;color:var(--text);font-variant-numeric:tabular-nums;border-radius:8px;padding:5px 13px;font-size:12px;font-weight:500;transition:background .12s,color .12s,border-color .12s}.seg:hover{background:var(--hover)}.seg.active{background:var(--accent);color:#fff;border-color:var(--accent)}.filters{gap:18px;margin-bottom:12px;display:flex}.filter{cursor:pointer;align-items:center;gap:6px;font-size:12.5px;font-weight:500;display:flex}.filter input{accent-color:var(--accent)}.chart-box{background:var(--card);border:.5px solid var(--border);box-shadow:var(--shadow);border-radius:12px;margin-bottom:18px;padding:14px 10px 6px}.tables{grid-template-columns:1fr 1fr;gap:18px;margin-bottom:18px;display:grid}.tables section{background:var(--card);border:.5px solid var(--border);box-shadow:var(--shadow);border-radius:12px;padding:16px 18px}table{border-collapse:collapse;width:100%;font-size:12.5px}th{text-align:left;border-bottom:.5px solid var(--border);padding:3px 0 6px}th:not(:first-child),td:not(:first-child){text-align:right}td{border-bottom:.5px solid var(--hairline);padding:5px 0}td:not(:first-child){font-family:var(--mono);font-variant-numeric:tabular-nums;letter-spacing:-.3px}tbody tr:last-child td{border-bottom:none}td:first-child{text-overflow:ellipsis;white-space:nowrap;max-width:260px;overflow:hidden}tbody tr{transition:background .12s}tbody tr:hover{background:var(--hover)}tfoot td{border-top:1px solid var(--border);padding:6px 0 2px;font-weight:650}.warn{color:#c98a1b}.settings{background:var(--card);border:.5px solid var(--border);box-shadow:var(--shadow);border-radius:12px;padding:16px 18px}.setting-row{justify-content:space-between;align-items:center;gap:24px;padding:9px 0;display:flex}.setting-row+.setting-row{border-top:.5px solid var(--hairline)}.setting-name{font-weight:550}.cookie-input{flex:none;gap:6px;display:flex}.cookie-input input{background:var(--bg);border:.5px solid var(--border);width:260px;color:var(--text);font-size:12px;font-family:var(--mono);border-radius:8px;padding:6px 8px}.cookie-input input:focus{border-color:var(--accent);box-shadow:0 0 0 3px var(--accent-soft);outline:none}.cookie-input button,.settings button{background:var(--card);border:.5px solid var(--border);cursor:pointer;color:var(--text);border-radius:8px;padding:6px 12px;font-weight:500;transition:background .12s}.cookie-input button:hover,.settings button:hover{background:var(--hover)}.help-link{color:var(--accent);cursor:pointer;text-decoration:none}.help-link:hover{text-decoration:underline}