Rabbitrabbit/ide

Docs / Agent

Hybrid routing & budgets.

How routing works

Rabbit uses a capability-aware routing policy: tool-calling and agentic work is only ever sent to models that can handle it, and cheaper steps prefer local or mid-tier models. You steer it with a small set of settings and let the fallback chain handle the rest.

Settings

Routing is driven by Rabbit AI settings (and the headers they produce):

rabbit-ai.routing.execution       auto     # auto · cloud · local  (X-Rabbit-Execution)
rabbit-ai.routing.preferProvider  auto     # or pin: anthropic · openai … (X-Rabbit-Prefer-Provider)
rabbit-ai.budget.dailyUsd         5.00     # soft daily cap — warns, does not block
rabbit-ai.budget.warnAtUsd        4.00     # threshold for the spend warning

execution expresses your preference for where a turn runs;preferProvider pins a provider slug when you want one, and falls back automatically when it is unavailable or incapable.

Fallback chains

Each capable route resolves through a fallback chain -- local → mid-tier cloud → frontier. When the primary model is unavailable (rate-limited, network error, budget warning), the router walks the chain until a model responds. A local fallback keeps the agent from stalling.

Budgets

rabbit-ai.budget.dailyUsd is a soft daily cap: once your spend approaches it, Rabbit surfaces a warning in the chat and status bar -- it does not hard-stop a conversation. Hard caps apply to background agent spawns, so a runaway fleet can't blow past your limit.

Cost tracking

Token usage and estimated cost are shown in the status bar in real time, and the session cost chip tracks per-conversation spend as you go.