@mauricode/token-derby 2.10.0 → 2.11.0

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 CHANGED
@@ -41,6 +41,23 @@ token-derby rejoin <join-code>
41
41
  token-derby end <admin-code>
42
42
  ```
43
43
 
44
+ ## Organisations
45
+
46
+ ```bash
47
+ # Join an organisation with a join token
48
+ token-derby organisation join <token>
49
+ ```
50
+
51
+ Everything else — creating an organisation, managing members, and configuring
52
+ the schedule or webhook — is done on the web:
53
+
54
+ ```bash
55
+ token-derby web
56
+ ```
57
+
58
+ This opens `token-derby.mauricode.co.uk/org-manager` with a one-time login
59
+ link, signed in as your CLI identity.
60
+
44
61
  ## What's tracked
45
62
 
46
63
  The CLI sums `message.usage.output_tokens` across every `*.jsonl` under `~/.claude/projects/`. This includes **subagents and dynamic workflows** — their transcripts nest under `<project>/<session>/subagents/…` (and `…/subagents/workflows/wf_<id>/…`), and the scanner recurses into all of them, so a Plan/Workflow that fans out across many agents counts all of that real output. Your "race tokens" are everything generated since the moment you joined. Tokens generated while disconnected are skipped — that window is your crash penalty.
@@ -76,4 +93,4 @@ at usage you didn't produce.
76
93
  - `TOKEN_DERBY_API_BASE` — override the API base URL (default: `https://token-derby.mauricode.co.uk/api`)
77
94
  - `TOKEN_DERBY_HOME` — override the data directory (default: `~/.token-derby`)
78
95
  - `TOKEN_DERBY_CLAUDE_DIR` — override the transcripts directory (default: `~/.claude/projects`)
79
- - **Top-5 conversations (primary):** a race can be created so that only each racer's **5 most-active conversations per heartbeat** count toward their **primary** model's score (secondaries unaffected). The race creator opts in at `token-derby create` (prompt) or on a schedule with `organisation schedule set --primary-top5`. Off by default (every conversation counts).
96
+ - **Top-5 conversations (primary):** a race can be created so that only each racer's **5 most-active conversations per heartbeat** count toward their **primary** model's score (secondaries unaffected). The race creator opts in at `token-derby create` (prompt) or, for organisation-scheduled races, via the "Primary top-5 cap" option on the schedule tab of `token-derby web`. Off by default (every conversation counts).