What is Crush?
Crush is Charm’s open-source, glamourous coding agent for the terminal. It is model-agnostic and supports custom providers in crush.json — and for any third-party OpenAI-compatible API you use the openai-compat provider type.
- A polished terminal agent that edits files and runs your tools.
- Custom providers go in
crush.jsonunderproviders. - Use the
openai-compattype for third-party OpenAI-compatible APIs (notopenai). - Open source, with a delightful Charm TUI.
Why route Crush through Tokonomix?
- One provider entry, 130+ models —
tokonomix-consensusfor hard turns, a fast slug for the rest. - Per-call spend caps keep a terminal agent within budget.
- Region / origin routing for regulated repositories.
- Reference your key from an environment variable, not the config file.
Connect Tokonomix in crush.json
Add a provider with type: "openai-compat", the Tokonomix base_url, an api_key env reference, and your model list.
{
"$schema": "https://charm.land/crush.json",
"providers": {
"tokonomix": {
"type": "openai-compat",
"base_url": "https://tokonomix.ai/api/v1",
"api_key": "$TOKONOMIX_API_KEY",
"models": [
{
"id": "tokonomix-consensus",
"name": "Tokonomix Consensus",
"context_window": 200000,
"default_max_tokens": 8192
}
]
}
}
}Per Crush’s docs, type: "openai" is only for proxying real OpenAI; for a third-party OpenAI-compatible API like Tokonomix use type: "openai-compat".
Verify it works
- Export
TOKONOMIX_API_KEY, savecrush.json, and start Crush. - Select the Tokonomix model and run a small task.
- Confirm the call and token usage in your Tokonomix dashboard.

