Skip to main content
Corbits Code is a coding agent that runs in your terminal. By the end of this page it will be installed, connected to a model, and working on a task in one of your repositories. You need macOS with Homebrew, a repository you are willing to let an agent edit, and a way to reach a model. For a local Ollama, start Ollama before choosing it; browser sign-in and API-key configuration happen in the guided flow. (provider setup source)
That is the whole path. The binary is corbits. No provider is configured yet, so a short setup opens before any work starts. Each step says where you are and what is left, as step 3 of 4 · api key. (provider setup source)
1

Pick a provider

OpenAI, xAI Grok, OpenCode Go, OpenCode Zen, Z.AI, Anthropic, Google, and a local Ollama, plus Custom for any other OpenAI-compatible endpoint. The prompt reads: pick the provider you have a key or subscription for. (provider setup source)
2

Name it

A suggested name is prefilled, so Enter is usually the whole step. This is the name you will see later in the /model picker, which matters once you have more than one provider or more than one account with the same provider.
3

Sign in, or paste a key

Corbits Code checks the credential against the provider before it saves anything. (provider catalog; credential validation)What a browser sign-in entitles you to is between you and that provider. If it leaves you without a usable model, pick a key-based provider or a local Ollama instead and carry on.
4

Pick a model

The models that provider serves. This is the same picker you will later see under /model, so what you choose here is what you will recognize when you change it.
/model returns you to model selection. If browser sign-in stops working after an account or subscription change, press Alt+A in that picker or run /connect to connect again. Select the refreshed account and model, then optionally press Alt+D to make it your default.
Corbits Code writes the provider to ~/.corbits/settings.json and launches straight into the task you gave it. You are not asked again on later runs. (provider persistence) You will know it worked when the terminal fills with the Corbits Code UI, your task sits at the top, and the event log shows the agent reading its first file. Cost and diffs update live as it works.

Then what

You are not just watching. Enter steers the agent mid-run, Ctrl+C interrupts, and /help lists everything else. Come back to a session later with corbits resume. (session controls) Corbits Code starts in auto mode: it edits files and runs ordinary shell commands without asking each time. A curated set of riskier shapes, among them dependency installs, recursive deletes, and anything touching a credential file, still stop for your approval; “Corbits Code in full” below has the complete list. Start with --no-auto if you would rather approve every consequential action while you get a feel for it. (auto-mode configuration; auto-mode shell policy) On your first run, you can explicitly enter /yolo to give Corbits Code full access to commands and capabilities. /yolo is not the default: Corbits Code may still ask questions related to your task, but it does not ask you to approve actions. (yolo command)

Corbits Code in full

The specialist fleet, the permission and secret guards, MCP servers, hooks, plugins, and what to do once one repository is not enough.

The Corbits platform

The runtime primitives Corbits Code is assembled from, and what else you can build on them.

Support

Help Center

Join hundreds of developers building with Corbits and speak with the team directly.