Providers & Models

Flowly Cloud

Flowly Cloud is the default provider: your Flowly account is the key. Sign in once and the agent has access to a curated set of top models, billed as credits against your plan. No API keys, no per-token math.

What you get

  • A curated set of frontier models (Claude, GPT, and more) behind one sign-in.
  • Usage billed as credits on your plan β€” no separate provider account.
  • Nothing to configure: it's on by default the moment you sign in.
  • The same models whether you're on the CLI, the desktop app, or paired to mobile.
This is the path the hosted setup picks
When you provision Flowly through the website, the setup chooses Flowly Cloud credits as the model mode by default β€” so for most people this page is already done.

Signing in

Flowly Cloud is active when two things are true: providers.flowly.enabled is on (the default) and you're signed in to your Flowly account. Sign in from the terminal chat:

bash
/login           # device-code sign-in to your Flowly account
/whoami          # confirm: shows your email + the active provider

On the desktop app, signing in (or pairing) does the same thing β€” Flowly Cloud becomes the active provider automatically.

Choosing a model

Pick which model your credits buy with the searchable model picker:

bash
/model           # searchable list of the models your plan includes

Your selection is saved as agents.defaults.model and applies on the next message. A common pattern: a fast, inexpensive model for everyday chat and a frontier model for hard reasoning β€” switch between them in two keystrokes.

Locked models are flagged up front
The picker only lets you choose models your plan includes. Models above your tier are shown locked rather than failing later at request time β€” upgrade on the billing page to unlock more.

Credits & billing

Flowly Cloud usage draws down credits included with your plan. How many credits a message costs depends on the model and the length of the conversation. Plans, included credits, and what each model costs are covered in detail under billing:

  • Plans β€” what each tier includes and which models it unlocks.
  • How credits work β€” what consumes credits and how to track usage.
Want to stop spending Flowly credits?
Switch to your own provider key β€” Flowly bills nothing in BYOK mode. See Bring your own key.

Turning it off

To stop using Flowly Cloud β€” for example to force a BYOK provider β€” disable the hosted slot. The fastest way is to switch the active provider with /provider; Flowly then uses your selected key instead. Disabling Flowly Cloud does not sign you out: mobile pairing and your account keep working.

bash
/provider        # pick a BYOK provider to take over as the active one