Providers

Switch the active provider and model

Understand the device-wide model selection that Kition saves when you sync a provider or use the Agent model picker.

Updated

By Kition Docs

Verified against Kition 0.2.0 (7d49036f) on 2026-11-06

The current selection model

Kition saves one active provider plus one selected model for each connected provider in its desktop settings. The selection is device-wide and is not stored inside each workspace. On a new install the active provider is Kition Cloud.

There is no three-level global/workspace/task default hierarchy. Changing the Agent model picker updates the saved active provider and selected model.

Note

Because this setting lives outside the workspace, copying a workspace to another device does not copy its provider selection or credentials.

Activate a provider through Sync now

  • Open Settings → AI Providers and select a configured provider
  • Choose Sync now
  • On success, Kition enables that provider and makes it active
  • If the previously selected model is missing, Kition selects a returned model automatically
  • Review that automatic choice in the Agent model picker before starting work

Switch from the Agent

The Agent model picker lists the synced models of every enabled provider, grouped by provider, with a Search models field. Selecting an entry saves both its provider and model, so the next Agent request uses the new selection.

Changing the selection does not cancel or rewrite a request that is already running. Wait for the current turn to finish or stop it before relying on the new model.

What switching does not do

  • It does not delete credentials for the previous provider
  • It does not move provider billing to Kition Cloud or between external providers
  • It does not guarantee that every returned model supports Agent tools, images, reasoning controls, or hosted web search
  • It does not create a workspace-specific override

If a model is missing or unusable

  • Run Sync now again after the provider grants model access
  • Confirm the provider remains enabled and its credential has not expired
  • Choose a text-generation model rather than an embedding, image, audio, or moderation model
  • Check that the model supports the provider’s wire API

Implementation sources

Related pages

Ready when you are.

Kition is a desktop AI workspace for connected documents, structured tables, editable designs, whiteboards, visual workflows, and reviewable AI agents.