Connect your AI accounts
Sign in to Claude, Codex and Gemini, add API keys for the other providers, and use several accounts side by side.
Neoo runs every agent on your own provider accounts. Everything on this page happens in Settings → Providers, which has four tabs: Accounts, Connections, API keys and Preferences. While Providers is open, the same four entries also appear under it in the settings sidebar.
Check which providers are ready
The Connections tab shows one card per provider, marked Connected or Not connected, and the tab label counts how many are connected (for example 4/10). Click Refresh to check again. If a card needs a command-line tool that isn't installed or signed in, click Open terminal: Neoo opens a terminal with the right install or sign-in command. Cards for providers that use an API key show Add API key, which opens the API keys tab.
| Provider | How to connect it |
|---|---|
| Claude, Codex, Gemini | Add an account (see below), or sign in with the provider's own CLI. |
| Cursor | In the API keys tab, paste your key into Cursor API key and click Save, or sign in with cursor-agent login. |
| OpenRouter | In the API keys tab, paste your key into OpenRouter API key and click Save. |
| Antigravity | In the API keys tab, paste a Gemini key into Gemini API key (Antigravity) and click Save. |
| Grok | Install the grok command-line tool, sign in with it, then restart Neoo. |
| OpenCode | Install OpenCode. Free models work without an account; run opencode auth login for the others. |
| Neoo AI | Nothing to do: it is ready as soon as you are signed in to Neoo. |
API keys are stored on this computer. A key that is set shows Configured. To delete one, click Remove next to its field.
Add Claude, Codex or Gemini accounts
The Accounts tab (opened by default) lists your saved accounts for Claude, Codex and Gemini. The account your CLI is signed in to is detected automatically and marked Current.
- Click Add account next to the provider.
- Finish the official sign-in in the browser page that opens.
- For Gemini, copy the code Google shows, paste it into Authorization code and click Submit code.
While Neoo waits, the button reads Cancel sign-in. Each account you add is kept in its own isolated profile on this computer, so adding one never changes your CLI login.
To manage an account, use the pencil icon to rename it or the trash icon to remove it. You can't remove the Current account: switch the CLI login first.
Use several accounts
In a Claude or Codex conversation, the key button in the message bar opens the account picker for that conversation.
- Automatic: Neoo chooses an available account and switches when its quota is reached. It also switches when the account's plan doesn't include the selected model (for example, Codex answers that a model "is not supported when using Codex with a ChatGPT account"); the same turn continues on another saved account that has the model. An account that hit its limit is skipped until its usage window resets, or sooner if the provider resets it early (Neoo notices on its next usage check, every few minutes). When every account is at its limit, sending fails with an error saying no saved account is available for this model: pick another model or wait for the reset.
- A saved account: the conversation always uses that account.
- Add: signs in another account without leaving the conversation.
You can't switch accounts while a turn is running. If the provider rejects an account, it shows Disconnected; use Reconnect to sign in again.
A Codex account whose sign-in was revoked or replaced (for example after signing in to the same ChatGPT account elsewhere) also shows Disconnected as soon as Neoo checks its usage limits, before you send a message. When a conversation stops on such an account, the Codex is not ready card above the message box has a Reconnect button: it opens the sign-in for that account, the same as Reconnect in the account menu. The codex login command shown with Open terminal only signs in the CLI login used outside Neoo accounts.
Installed CLI or bundled runtime
Claude, Codex and Gemini turns run on the CLI installed on your computer when it is recent enough. Otherwise Neoo uses its own copy. The provider card in the Connections tab tells you which one is used:
- Installed CLI · version: your own CLI.
- Neoo bundled runtime · version: Neoo's copy.
When Neoo skips your CLI, for example because it is too old, a short warning follows the version. Claude Code needs version 2.1.280 or later, and the Codex CLI version 0.124.0 or later.
Updates, visibility and usage
These settings are in the Preferences tab.
- Provider updates lists provider tools that Neoo can update. Click Update on a row.
- Automatic CLI update checks also tells you about new versions in the navigation bar at the top of the window (see below).
- Visible providers sets the order of providers in the model picker. Drag to reorder, or hide the ones you don't use.
Settings → Usage & quotasshows how much of each account's allowance is left.
CLI update alert
When a new version of Claude Code or the Codex CLI is available and Neoo can install it for you, the navigation bar at the top of the window briefly shows Claude Code version is available instead of its buttons. Neoo checks shortly after it starts, then every hour. The alert waits until no agent is working.
- Install (or Install all when both CLIs have an update) updates the CLI. The navigation comes back right away, and the installation moves next to the notification and Settings buttons: the CLI logo with a spinning ring. Hover it to see the version being installed; click it to open
Settings → Providers. When it is done, the bar briefly shows that the CLI was updated. The new version is used from your next message. - Skip ignores this version. You are told again when the next version comes out.
- ✕, or Esc while the alert has focus, hides it until you restart Neoo. A dot on the Settings button keeps the update visible; clicking it opens
Settings → Providers.
If the update fails, the bar shows the error with Details (opens Settings → Providers) and Retry. To stop these alerts, turn off Automatic CLI update checks in Settings → Providers.