Burnmydays Claude Opus 4.8 (1M context) commited on
Commit
17d4fa9
·
1 Parent(s): b92c3a7

docs: lead with the local importer (local-first), paste is the backup

Browse files

Per owner: the importer is the real path. Clock Your Signal tab + README now
open with ./sigrank (① / Primary) and present the ccusage paste as the backup
for when there's no repo. Codex/separate-providers warning kept.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Files changed (2) hide show
  1. README.md +16 -14
  2. app.py +20 -24
README.md CHANGED
@@ -54,12 +54,21 @@ or four numbers →
54
  - **leaderboard placement** vs real operators, ranked by Υ, with blended **$/1M cost**
55
 
56
  ## How to measure yourself
57
- Three things: **what data, where to get it, where to put it.**
58
 
59
- **1 — What / where to get it.** SigRank needs four integers `input`, `output`,
60
- `cache_create`, `cache_read`. [`ccusage`](https://github.com/ryoppippi/ccusage) reads
61
- them from your local logs (needs Node.js). Run **one command per provider** — Claude and
62
- Codex are different operators, so measure them **separately** (each command on its own line):
 
 
 
 
 
 
 
 
 
63
 
64
  ```
65
  npx ccusage@latest claude --json
@@ -68,19 +77,12 @@ npx ccusage@latest claude --json
68
  npx ccusage@latest codex --json
69
  ```
70
 
71
- (If ccusage is installed globally, drop the prefix: `ccusage claude --json`.)
 
72
 
73
  > ⚠️ Don't use bare `ccusage --json` (no subcommand): it merges every agent into one
74
  > total, which inflates input and distorts the architecture read.
75
 
76
- **2 — Where to put it.** Either:
77
-
78
- - **Local importer (no paste):** `./sigrank` (Claude), `./sigrank --codex` (Codex),
79
- or `./sigrank --all` (each provider in turn). Reads your usage on your machine and
80
- prints your profile + board rank. Nothing leaves your computer.
81
- - **Hosted Space:** paste one provider's JSON into the **Clock Your Signal** box, or type
82
- the four numbers `input output cache_create cache_read`.
83
-
84
  **3 — Saving (optional).** On the Space, sign in with HuggingFace to earn one persistent
85
  board entry + session history (Greatest Hits). Without login, your read is a live
86
  snapshot only — scored against the field but not saved.
 
54
  - **leaderboard placement** vs real operators, ranked by Υ, with blended **$/1M cost**
55
 
56
  ## How to measure yourself
57
+ SigRank is **local-first** the importer reads your usage on your own machine.
58
 
59
+ **1 — Primary: the local importer.** From the cloned repo, run the command on its own line:
60
+
61
+ ```
62
+ ./sigrank
63
+ ```
64
+
65
+ `./sigrank --codex` for Codex, `./sigrank --all` for both. It runs `ccusage` for you,
66
+ computes your profile + Υ, and prints your board rank. **Nothing leaves your machine.**
67
+ Needs the repo + Python + [Node.js](https://nodejs.org) (for ccusage).
68
+
69
+ **2 — Backup: paste on the Space.** No repo? Run `ccusage` yourself and paste the JSON
70
+ into the **Clock Your Signal** box. Run **one command per provider** (Claude and Codex are
71
+ different operators — measure them separately):
72
 
73
  ```
74
  npx ccusage@latest claude --json
 
77
  npx ccusage@latest codex --json
78
  ```
79
 
80
+ (ccusage installed globally? drop the prefix: `ccusage claude --json`.) Or type four
81
+ numbers: `input output cache_create cache_read`.
82
 
83
  > ⚠️ Don't use bare `ccusage --json` (no subcommand): it merges every agent into one
84
  > total, which inflates input and distorts the architecture read.
85
 
 
 
 
 
 
 
 
 
86
  **3 — Saving (optional).** On the Space, sign in with HuggingFace to earn one persistent
87
  board entry + session history (Greatest Hits). Without login, your read is a live
88
  snapshot only — scored against the field but not saved.
app.py CHANGED
@@ -364,41 +364,37 @@ def _build_demo():
364
  op_pick.change(view_operator, op_pick, [op_prof, op_card])
365
 
366
  with gr.Tab("Clock Your Signal"):
367
- gr.Markdown("""### Clock your signal \u2014 4 steps
368
 
369
- **Step 1 \u00b7 Pull your usage.** In your terminal (needs [Node.js](https://nodejs.org)),
370
- run **one** of these and copy the JSON it prints.
 
 
 
 
 
 
371
 
372
- Claude Code:
 
373
  ```
374
  npx ccusage@latest claude --json
375
  ```
376
- Codex:
377
  ```
378
  npx ccusage@latest codex --json
379
  ```
380
- Already have ccusage installed? Drop the prefix and just run `ccusage claude --json`.
381
- \u26a0\ufe0f Run Claude and Codex **separately** \u2014 never bare `ccusage --json` (no provider). That
382
- merges every agent into one total and distorts your read.
383
-
384
- **Step 2 \u00b7 Paste it in the box below** and press **Clock My Signal**. No JSON? Type four
385
- numbers in order: `input output cache_create cache_read`.
386
 
387
- **Step 3 \u00b7 Read your profile** \u2014 archetype, cascade, full metrics, and your live board
388
- placement appear right below.
389
 
390
- **Step 4 \u00b7 (optional) Sign in with HuggingFace** to save your entry to the board + keep
391
- session history (Greatest Hits). Without login it's a live snapshot only.
392
 
393
- ---
394
- **Local importer (optional \u2014 only if you've cloned the repo).** From inside the repo
395
- folder, run the command **on its own line** (don't paste any trailing notes):
396
- ```
397
- ./sigrank
398
- ```
399
- Use `./sigrank --codex` for Codex or `./sigrank --all` for both. Needs the repo + Node +
400
- Python. *Codex input is estimated (`*`): alone \u2192 AA 2:1 baseline; with a Claude profile \u2192
401
- your own Claude input:output ratio.*""")
402
  if _ON_SPACE:
403
  gr.LoginButton(elem_id="hf-login-btn")
404
  else:
 
364
  op_pick.change(view_operator, op_pick, [op_prof, op_card])
365
 
366
  with gr.Tab("Clock Your Signal"):
367
+ gr.Markdown("""### Clock your signal \u2014 local-first
368
 
369
+ **\u2460 Run the local importer \u2014 the real path.** From the repo folder, run the command
370
+ **on its own line** (don't paste any trailing notes):
371
+ ```
372
+ ./sigrank
373
+ ```
374
+ `./sigrank --codex` for Codex \u00b7 `./sigrank --all` for both. It reads your usage on your
375
+ machine, computes your profile + \u03a5, and prints your board rank. **No paste, no upload \u2014
376
+ nothing leaves your computer.** (Needs the repo + Python + Node.)
377
 
378
+ **\u2461 No repo handy? Paste instead (the backup).** In your terminal run one of these
379
+ (needs [Node.js](https://nodejs.org)), copy the JSON, and drop it in the box below:
380
  ```
381
  npx ccusage@latest claude --json
382
  ```
 
383
  ```
384
  npx ccusage@latest codex --json
385
  ```
386
+ Already have ccusage installed? Just `ccusage claude --json`. \u26a0\ufe0f Run Claude and Codex
387
+ **separately** \u2014 never bare `ccusage --json` (it merges every agent and distorts the read).
388
+ No JSON? Type four numbers in order: `input output cache_create cache_read`.
 
 
 
389
 
390
+ **\u2462 Read your profile** \u2014 archetype, cascade, full metrics, and your live board placement
391
+ appear right below.
392
 
393
+ **\u2463 (optional) Sign in with HuggingFace** to save your entry + session history (Greatest
394
+ Hits). Without login it's a live snapshot only.
395
 
396
+ *Codex input is estimated (`*`): alone \u2192 AA 2:1 baseline; with a Claude profile \u2192 your own
397
+ Claude input:output ratio.*""")
 
 
 
 
 
 
 
398
  if _ON_SPACE:
399
  gr.LoginButton(elem_id="hf-login-btn")
400
  else: