Settings
Manage your Kepler account, API keys, billing, and preferences from the dashboard at bahulam.ai.
Dashboard
The dashboard is your central hub for Kepler account management.
Sections
| Section | Purpose |
|---|---|
| Profile | GitHub username, email, avatar, plan tier |
| Sessions | History of Kepler CLI sessions |
| Billing | Plan management, credits, invoices |
| Models | Set default model, configure sub-agent routing |
| API Keys | Manage BYOK provider keys |
| Preferences | Theme, editor settings, defaults |
Plans & Billing
Platform Default
The platform default uses Kepler’s hosted model routing. You are billed in credits based on token usage. Your plan determines how many credits you get per month.
| Plan | Monthly Credits | Price |
|---|---|---|
| Pro | 50,000 | $19/mo |
| Plus | 200,000 | $49/mo |
| Max | 500,000 | $99/mo |
Credits View
The credits widget in the dashboard shows:
- Current balance — available credits
- Usage this month — credits consumed
- Plan tier — your current subscription
- Credit packs — one-time top-up purchases
Credits roll over month-to-month on annual plans. On monthly plans, unused credits expire at the end of the billing cycle.
BYOK (Bring Your Own Key)
When you configure a BYOK provider, Kepler routes requests through your API key instead of the platform gateway. In BYOK mode:
- Credits are not consumed — your provider bills you directly
- You can use any supported model — not just the platform default set
- Sub-agent routing still applies — but uses model IDs you configure
To set up BYOK:
- Go to Settings → API Keys
- Choose a provider (OpenRouter, Anthropic, OpenAI, etc.)
- Enter your API key
- Save — the key is encrypted and stored securely
You can also set keys via environment variables:
export OPENROUTER_API_KEY="sk-or-v1-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."Platform Default vs BYOK
| Aspect | Platform Default | BYOK |
|---|---|---|
| Setup | None — works out of the box | Requires API key |
| Billing | Credits from your plan | Direct provider billing |
| Models | Curated set | Full provider catalog |
| Caching | Platform-managed | Provider-managed |
| Data handling | Via Kepler infrastructure | Via provider infrastructure |
You can switch between platform default and BYOK at any time — no config changes needed. Kepler auto-detects which gateway to use based on the model selected.
Model Settings
In Settings → Models, you can configure:
- Default model — the model used for your primary coding turns
- Explorer model — the model used for read-only sub-agent passes
- Planner model — the model used for planning sub-agent passes
Each setting has a dropdown filtered by the available models for your selected gateway.
Profile
Your profile page shows:
- Email — the email associated with your GitHub account
- GitHub username — used for authentication
- Plan — your current tier
- BYOK status — whether a custom API key is configured
Preferences
- Theme — light, dark, or system default
- Editor preferences — font size, line height (for Studio workspace)
- Default workspace — which workspace type loads on login