Set up agent providers

Switch works with these AI coding agents: Claude Code, OpenCode, Codex, Cursor, and Antigravity. We call the one you choose your agent provider. Switch doesn’t include its own AI agent. Instead, it starts your chosen provider under your own account, on a machine you control: this computer, or a remote host you’ve onboarded, such as a virtual machine or another machine you reach over SSH. What Auto mode lets an agent do without asking depends on the provider. See Let the agent act without asking.

Before you begin

Switch starts the provider wherever the agent runs. For an agent on this computer, set the provider up here. For an agent on a remote host, set it up on the host. See Run an agent on the host.

Check your agent provider

At the bottom of the sidebar, select Settings, then Agent providers. The list is headed All agents and shows every provider Switch supports. The line under each provider’s name says whether it’s ready: Go by the line under the name, not the Installed or Not installed badge. A row can read Installed while the provider still isn’t ready.

Install the provider

Select the provider to open its details. If it isn’t installed, Switch Console offers to install it there. If Switch Console can’t install it on your computer, install the provider’s command-line tool (CLI) the way its own documentation describes. Then, on Agent providers, select the refresh icon. Switch Console checks ~/.local/bin each time you refresh, so it finds a CLI installed there without a restart. If the line still reads CLI not installed, the installer put the CLI somewhere else. Quit Switch Console completely and open it again, so it rereads your PATH: If it still reads CLI not installed after you reopen Switch Console, see Getting an agent running.

Sign in to the provider

Select the provider to open its details. Under Run in a terminal on this computer, then Recheck, the details show the provider’s sign-in command, with a Copy button. Run the command in a terminal, sign in, then select Recheck. For a provider on a remote host, sign in from the host instead. See Run an agent on the host. Switch uses the account the provider is signed in to, whether that’s a subscription or an API key. When you first set up switch-buddy, its setup runs the sign-in for you. From Agent providers, Switch Console can’t sign you in itself. If the sign-in command doesn’t work for you, see the provider’s own documentation.

Confirm the setup

You’re ready to add an agent when:

• The line under the provider’s name reads Signed in.
• The card in its details reads Signed in and CLI installed.

For example, a Claude Code setup that’s ready reads Signed in under the name. Its card reads Claude Code · Signed in, with On this computer · CLI installed beneath.

Update the provider

Switch Console also shows when a newer version of the provider CLI is available. In the provider’s details, the Installation section reads Newer version available, with the command it runs and an Update button. This updates your provider, not Switch.

Next steps