Managing the Provider Library

Adding, removing, renaming, setting defaults, and the deletion guard that prevents breaking active workflows.

Open Settings → Providers to manage the library. The tab lists every credential you've added.

Adding a provider

Click + Add provider. The setup pane opens. On a first connection it starts by asking What do you already have? — ChatGPT Plus or Pro, Claude Pro or Max, A Google account, An API key, or Nothing yet — run free on this computer — and takes you straight to the matching tile. Every tile says what you need and roughly how long it takes; the less common ones wait behind More options.

See Connect a model provider for the per-type walkthroughs.

Renaming a provider

Click the pencil icon next to the provider's name. Type a new label. Press Enter.

Names are display-only; they don't affect behavior. Make them descriptive ("Ollama: M2 MacBook", "OpenRouter via personal account") if you have many.

Setting the default

Click Set as default on any entry. The old default loses the badge; the new entry gains it. Background features (chat builder fallback, retrospectives, etc.) switch over immediately.

You can't unset the default, there's always exactly one.

Removing a provider

Click the trash icon on the entry. Cerevisor checks if any open workflow has agents that reference this provider:

  • No agents reference it: Removal proceeds immediately.
  • One or more agents reference it: Removal is blocked. A toast lists the affected agents (workflow name + agent name).

To fix:

  1. Open each affected workflow.
  2. For each affected agent, change the provider (Agent Config → Provider) to a different library entry, or revert to inherit.
  3. Re-try the removal.

This guard exists because silently deleting a provider would leave agents in a broken state.

Key rotation

To rotate an API key:

  1. Open Settings → Providers.
  2. Click Edit on the entry.
  3. Paste the new key.
  4. Click Test connection.
  5. Save.

The OS keychain entry is overwritten. Workflows using this provider pick up the new key on their next run, no restart needed.

Multiple OpenAI-compatible entries

The OpenAI-compatible type is the only one that allows multiple entries. Common pattern:

  • OpenAI (hosted): for production work where reliability matters.
  • Ollama (local): for cheap iteration during development.
  • OpenRouter: for trying exotic models.

Each entry is independent. The default is one of them; agents can override per-agent to any other.

Workflow-level provider override

In addition to the library default, each workflow can pin its own default in Settings → Workflow → Provider override. It is saved in the workflow file, so it travels with the workflow when you share it.

If a recipient doesn't have a matching credential, Cerevisor falls back to the library default at run time.

Model defaults per provider

In each library entry's settings, the Default model picker lets you set the model that agents on Auto use. Useful when you have a strong preference (for example, "always the mid-size model on this provider, never the largest").

The list shows the models your account can use on that provider. Press Refresh models to bring in new ones. See Keeping your models current.

Auth troubleshooting

Some failure modes by provider:

Provider Symptom Likely fix
Anthropic 401 Key revoked or wrong. Regenerate in console.
OpenAI-compatible (OpenAI) 401 Same. Check platform.openai.com.
Ollama ECONNREFUSED Ollama isn't running. ollama serve or open the desktop app.
ChatGPT Plus / Pro (via Codex) "Cerevisor can't find Codex on this computer" Open the entry and click Install Codex — Cerevisor installs it for you — then Check again.
ChatGPT Plus / Pro (via Codex) "Not signed in", or Sign-in stopped before it finished Press Sign in with ChatGPT again, or choose Use a code instead.
Cursor "This copy of Cerevisor is missing the part that talks to Cursor" Reinstall Cerevisor from cerevisor.com — your workflows and settings are kept.
Cursor Agent "Invalid API key" Regenerate at cursor.com/dashboard.
Google AI plan (via Antigravity) "not found" Open the entry and click Install (Cerevisor runs Google's own installer for you), or install from antigravity.google, then click Re-check — no restart needed.
Google AI plan (via Antigravity) "Not signed in" Press Sign in again — your browser opens for the Google sign-in, and the panel finishes the check by itself when you come back.

Back to docs