# Set up your coding agent

Use the CLI and login you already have, then check the connection in Zoltbot.

macOS · Early release

## Install and sign in first

Install the provider’s command-line tool using its official instructions, then sign in through that tool. Installing an editor alone may not install its CLI. Zoltbot launches the CLI and uses its existing configuration.

The table below covers the native integrations described in the public setup guides. Other definitions may appear in the app; appearing in the catalog does not guarantee that an integration has been verified.

| Agent | Executable | Native sign-in |
| --- | --- | --- |
| Claude Code | `claude` | `claude auth login` |
| Codex | `codex` | `codex login` |
| Cursor | `cursor-agent` or `agent` | Run the selected executable with `login` |
| Antigravity | `agy` | Run `agy` and complete interactive sign-in |
| OpenCode | `opencode` | `opencode auth login` |
| GitHub Copilot | `copilot` | `copilot login` |

## Check detection in Zoltbot

A scan checks installed tools and login state without sending a model prompt. **Login unknown** does not confirm a working login; try the tool directly if connection fails.

1. Open **Settings → Coding agents** (Doctor).
2. Choose **Scan coding tools** after installing, updating, or signing in to a CLI.
3. Check the selected install path, version-support label, and login state.
4. Use **Open workspace setup** to connect the tool and create a starter profile.

## Expect provider differences

Zoltbot does not copy native provider credentials into its database. If authentication expires, sign in with the native tool again. The chat’s **Context** panel provides sign-in guidance for its selected executable.

- Claude Code and Codex use native CLI protocols. Cursor, Antigravity, OpenCode, and Copilot use their ACP interfaces.
- Cursor requires an ACP-capable CLI. Antigravity uses `agy acp --process-per-session`.
- Models, modes, approvals, and usage reporting depend on the provider. Doctor’s **Declared capabilities** are definition metadata; a native connection must confirm runtime support.
- Antigravity is the documented Gemini integration. The standalone Gemini CLI is not in the built-in catalog.
- Native read-only and write modes are provider permissions, not OS-level isolation.
