Reference
Providers and routes, CLI commands, and environment variables
Quick lookup for the facts you need while deploying and integrating Sentinel.
Supported providers & intercepted routes
The gateway exposes each provider under its own path and intercepts only the text generation route below. All other routes for a provider pass through untouched.
| Provider | CLI name | Client base-URL variable | Gateway path | Intercepted route |
|---|---|---|---|---|
| OpenAI | openai | OPENAI_BASE_URL | /openai | v1/chat/completions |
| Anthropic | anthropic | ANTHROPIC_BASE_URL | /anthropic | v1/messages |
| Gemini | google | GOOGLE_GEMINI_BASE_URL | /gemini | *generateContent* |
| Custom | (as named) | OPENAI_BASE_URL | /{provider_name} | v1/chat/completions |
CLI commands
| Command | Description |
|---|---|
sentinel --version | Show the installed CLI version. |
sentinel quickstart | Guided setup: create or connect a gateway, choose providers, and enable the proxy. |
sentinel auth | Authenticate with your SUPERWISE® Client ID and Client Secret (generate tokens). |
sentinel gateway start | Bootstrap and run a local gateway container (--sentinel-id optional). |
sentinel gateway stop | Stop and remove the local gateway container. |
sentinel config url | Set the gateway URL to route traffic to. |
sentinel config providers | Choose which providers to intercept (openai, anthropic, google, or all). |
sentinel proxy on | Inject the provider base-URL variables into new shell sessions. |
sentinel proxy off | Remove the variables and restore direct-to-cloud routing. |
The CLI persists its state to ~/.config/sentinel/config.json (%APPDATA%\sentinel\config.json on Windows).
Gateway container environment variables
| Variable | Required | Description |
|---|---|---|
SENTINEL_ID | Yes | The Sentinel ID registered in the SUPERWISE® platform. |
SW_CLIENT_ID | Yes | SUPERWISE® API Client ID used to register with the control plane (generate tokens). |
SW_CLIENT_SECRET | Yes | SUPERWISE® API Client Secret. |
CUSTOM_PROVIDERS | No | JSON array of {provider_name, base_url} objects for OpenAI-compatible backends. See Custom providers. |
Gateway states
| State | Meaning |
|---|---|
Pending | No heartbeat received yet, or no heartbeat in the last 10 minutes. |
Active | A heartbeat was received within the last 10 minutes (heartbeats are sent every 60 seconds). |