CLI reference

Four commands you'll actually run, plus the flag that applies to all of them.

fitguard init

Interactive setup. Asks which providers you're using, a real API key for each, cache settings, and any number of budgeted users, each getting a generated virtual key back. Last step, a dashboard login (skippable). Writes config.yaml in the current directory.

fitguard init

Numeric answers (port, daily budget) are validated and re-prompt on bad input rather than silently substituting a default, a malformed budget can't turn into an accidental unlimited one. If config.yaml already exists, you're asked to confirm before it's overwritten, existing virtual keys aren't recoverable once that happens.

fitguard add-provider

Adds one or more providers (openai, anthropic, gemini, groq, together) to an existing config.yaml without the destructive overwrite flow of init. Prompts for an API key per provider you select; providers already configured are shown but skipped unless re-selected. Everything else — virtual keys, budgets, the dashboard login — is left untouched.

fitguard add-provider

Adding a provider also widens which models fallback: will accept: a fallback model is only valid if the provider that serves it is configured, so this is how you unlock a new fallback target. Restart fitguard run for the new provider to take effect.

fitguard run

Loads config.yaml, starts the proxy and the dashboard, and blocks until stopped.

fitguard run

Ctrl+C (or SIGTERM) triggers a graceful shutdown: it stops accepting new connections, waits up to 10 seconds for in-flight requests to finish, then exits.

fitguard reset-dashboard-password

Sets or resets the dashboard's one admin account: a username, then a masked, confirmed password. Doesn't need the server running or the current password — it's the recovery path, since there's no email system here to send a reset link through. Also how you add a dashboard login later if you skipped it during init.

fitguard reset-dashboard-password

Rotates the session secret too, so it signs out any existing dashboard session, not just changes the password.

Global flags

fitguard run --config /path/to/prod.yaml

Every command supports --help for its full description and examples.