Providers & Models

    Wingman supports multiple model providers and a dedicated voice provider. Models are referenced with the format:

    provider:model-name

    Examples:

    • anthropic:claude-sonnet-4-5
    • openai:gpt-4o
    • codex:codex-mini-latest
    • openrouter:openai/gpt-4o
    • copilot:gpt-4o
    • xai:grok-beta
    • xai:grok-imagine-image

    Configure a provider

    Use the CLI to store credentials:

    wingman provider login anthropic
wingman provider login openai
wingman provider login codex
wingman provider login openrouter

    Or supply env vars (see table below). The CLI reads env vars first, then ~/.wingman/credentials.json.

    Supported providers

    ProviderCategoryAuthEnv varsNotes
    anthropicmodelAPI keyANTHROPIC_API_KEYRecommended for Claude models.
    openaimodelAPI keyOPENAI_API_KEYGPT-4o, GPT-4.1, etc.
    codexmodelsubscription tokenCODEX_ACCESS_TOKEN, CHATGPT_ACCESS_TOKENUses ChatGPT Codex backend (https://chatgpt.com/backend-api/codex) and reads CODEX_HOME/auth.json or ~/.codex/auth.json when available.
    openroutermodelAPI keyOPENROUTER_API_KEYUses OpenRouter routing (https://openrouter.ai/api/v1).
    copilotmodelAPI keyGITHUB_COPILOT_TOKEN, COPILOT_TOKEN, COPILOT_API_KEYToken-based access.
    xaimodelAPI keyXAI_API_KEYGrok text + image models (for example grok-imagine-image).
    lmstudiomodeloptionalLMSTUDIO_API_KEY, LM_STUDIO_API_KEYDefaults to http://localhost:1234/v1.
    ollamamodeloptionalOLLAMA_API_KEYDefaults to http://localhost:11434.
    elevenlabsvoiceAPI keyELEVENLABS_API_KEY, XI_API_KEYUsed for text-to-speech.

    For xai:grok-imagine-image, Wingman uses xAI's native images endpoint (/v1/images/generations) so image output works even when chat-model adapters do not support that model.

    Model overrides per agent

    You can override the model in agent.json or agent.md:

    {
  "name": "reviewer",
  "description": "Reviews code changes.",
  "systemPrompt": "Review diffs for correctness and risk.",
  "model": "openai:gpt-4o"
}

    Provider status

    Check which providers are configured:

    wingman provider status