Skip to content

grok accounts #29

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
pedroapfilho wants to merge 1 commit into
base: main
Choose a base branch
from
Open

grok accounts #29

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
- [2026-09-08] grok accounts
- [2026-08-21] codex keeps its shell and apply_patch tools on the gpt-5.6 models
- [2026-08-18] meter clients that hang up early
- [2026-08-18] reclaim bare provider tables
Expand Down
26 changes: 13 additions & 13 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@

<br/>

**One dashboard for all of your Codex and Claude Code accounts. Easily switch between them, and monitor usage.**
**One dashboard for all of your Codex, Claude Code and Grok accounts. Easily switch between them, and monitor usage.**

<sub>macOS · [Bun](https://bun.sh) · a [Rubric Labs](https://rubriclabs.com) project · not affiliated with OpenAI or Anthropic</sub>
<sub>macOS · [Bun](https://bun.sh) · a [Rubric Labs](https://rubriclabs.com) project · not affiliated with OpenAI, Anthropic or xAI</sub>

<br/><br/>

Expand All @@ -26,7 +26,7 @@ tokenmaxx #starts the dashboard

## What it does

You run a fleet of coding agents using multiple Codex or Claude accounts:
You run a fleet of coding agents using multiple Codex, Claude or Grok accounts:

<div align="center">
<img alt="a desktop full of parallel agent sessions burning tokens" src="media/fleet.gif" width="820">
Expand All @@ -42,7 +42,7 @@ Run `tokenmaxx`. **Accounts** shows every account and its live rate-limit window
<img alt="every account and its live rate-limit windows, colored by pressure" src="media/accounts.png" width="820">
</div>

**Analytics** is combined token throughput across all accounts and both providers, with the ≈ cost of that usage at API list rates. Tokens are metered as responses stream by, never buffered, so every number is cross-checkable against your clients' own session logs. Press `m` for the full pricing breakdown per model.
**Analytics** is combined token throughput across all accounts and every provider, with the ≈ cost of that usage at API list rates. Tokens are metered as responses stream by, never buffered, so every number is cross-checkable against your clients' own session logs. Press `m` for the full pricing breakdown per model.

<div align="center">
<img alt="combined token throughput and API-list-price cost across all accounts" src="media/analytics.png" width="820">
Expand All @@ -59,27 +59,27 @@ Run `tokenmaxx`. **Accounts** shows every account and its live rate-limit window
Turn it on and tokenmaxx watches the active account's rate-limit windows. When the fullest one crosses your threshold, it switches to whichever of your accounts has the most room. The default threshold is 90%, which leaves the last stretch of every window alone in case you want it later. If an account hits a hard limit in the middle of a request, the proxy retries that request on your next account with room.

```bash
tokenmaxx auto both on --threshold 90 # or: codex | claude … off
tokenmaxx auto all on --threshold 90 # or: codex | claude | grok … off
```

## How it works

A single loopback proxy on `127.0.0.1:8459`, and the clients you already use.

- **Account per request.** The proxy reads which account is active for each request and attaches its credential. Switching lands on the next request.
- **Pressure read for free.** Both providers report rate-limit state on every response; the proxy reads it as traffic streams by, so it always knows how full the active account is, with zero extra requests.
- **Official apps only.** Your subscription login is for Claude Code and Codex. If you're building something custom, use an API key from the provider. tokenmaxx doesn't turn a subscription into an API plan.
- **Pressure read for free.** Codex and Claude report rate-limit state on every response; the proxy reads it as traffic streams by, so it always knows how full the active account is, with zero extra requests. Grok reports nothing until it says no, so a Grok account's meter is empty until a 429 fills it, and auto-rotation for Grok is driven by hard limits rather than a threshold.
- **Official apps only.** Your subscription login is for Claude Code, Codex and the grok CLI. If you're building something custom, use an API key from the provider. tokenmaxx doesn't turn a subscription into an API plan.

## Commands

```text
tokenmaxx live dashboard
tokenmaxx login <codex|claude> sign in; isolated, idempotent
tokenmaxx install route native codex & claude
tokenmaxx login <codex|claude|grok> sign in; isolated, idempotent
tokenmaxx install route native codex, claude & grok
tokenmaxx uninstall restore native config
tokenmaxx switch <codex|claude> <email> make an account active
tokenmaxx logout [codex|claude] <email> sign out; the credential is deleted
tokenmaxx auto <both|codex|claude> <on|off> [--threshold N]
tokenmaxx switch <codex|claude|grok> <email> make an account active
tokenmaxx logout [codex|claude|grok] <email> sign out; the credential is deleted
tokenmaxx auto <all|codex|claude|grok> <on|off> [--threshold N]
tokenmaxx list | status | refresh | doctor
```

Expand All @@ -94,7 +94,7 @@ tokenmaxx is for one person with accounts they pay for themselves. No account ge
## Not affiliated

An independent [Rubric Labs](https://rubriclabs.com) project, not an official
product of, affiliated with, or endorsed by OpenAI or Anthropic. Inspired by
product of, affiliated with, or endorsed by OpenAI, Anthropic or xAI. Inspired by
[codex-account-switcher](https://github.com/Sls0n/codex-account-switcher).

<div align="center">
Expand Down
5 changes: 3 additions & 2 deletions package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
"@opentui/core": "^0.4.3",
"zod": "^4.0.0"
},
"description": "Switch between your own Codex and Claude Code accounts from one local dashboard, with live token analytics.",
"description": "Switch between your own Codex, Claude Code and Grok accounts from one local dashboard, with live token analytics.",
"devDependencies": {
"@biomejs/biome": "^2.0.0",
"@rubriclab/config": "*",
Expand All @@ -29,6 +29,7 @@
"claude-code",
"cli",
"codex",
"grok",
"proxy",
"rate-limits",
"rubric",
Expand Down Expand Up @@ -59,5 +60,5 @@
"post-commit": "bun x @rubriclab/package post-commit"
},
"type": "module",
"version": "0.0.66"
"version": "0.0.67"
}
10 changes: 1 addition & 9 deletions src/claude.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ import {
} from './domain.ts'
import { ApplicationError, loginFailureMessage } from './errors.ts'
import { type UpstreamInjection, upstreamFor } from './proxy.ts'
import { type CredentialVault, exclusive } from './vault.ts'
import { type CredentialVault, exclusive, readApiKey } from './vault.ts'

const clientId = '9d1c250a-e61b-44d9-88ed-5944d1962f5e'
const tokenEndpoint = 'https://console.anthropic.com/v1/oauth/token'
Expand Down Expand Up @@ -203,14 +203,6 @@ async function readClaudeCredential(
return ClaudeOauthSchema.parse(JSON.parse(serialized))
}

async function readApiKey(vault: CredentialVault, reference: string): Promise<string> {
const key = await vault.read(reference)
if (key === null) {
throw new ApplicationError('CREDENTIAL_MISSING', `Missing credential ${reference}`)
}
return key
}

const anthropicVersion = '2023-06-01'

async function validateAnthropicApiKey(
Expand Down
Loading
Loading