AI Providers
Coeus doesn't have a built-in AI. You connect it to a provider you already use, or one you sign up for. This means you pick the model, you control the cost, and you can switch at any time.
Provider types
There are two main categories:
Agent runtimes: These run a full AI agent on your machine or connect to a locally-installed AI tool. They can read and write files in your notes folder directly. Coeus sends the conversation and context; the agent takes it from there.
Raw API providers: You give Coeus an API key, and it calls the AI API directly. The AI sees your notes as context in the prompt. Simpler setup, works with any model that has an API.
Available providers
| Provider | Type | What it is |
|---|---|---|
| Claude Code | Agent runtime | Uses your Claude Code subscription via its CLI |
| Codex | Agent runtime | Uses OpenAI's Codex CLI (requires ChatGPT Plus or Teams) |
| ACP Agent | Agent runtime | Any agent that speaks the Agent Client Protocol |
| Anthropic API | Raw API | Direct access to Claude models via API key |
| OpenAI-compatible API | Raw API | OpenAI, or any API with the same format (local models, etc.) |
| Kimi Coding | Raw API | Kimi's coding-focused model |
| Coeus Cloud | Raw API | Hosted option, no API key needed |
Which one should I use?
If you already use Claude Code: set up the Claude Code provider. It's the most capable option and uses your existing subscription.
If you want the easiest setup: use the Anthropic API or OpenAI-compatible API. You put in an API key and it works.
If you want to run everything locally: set up Ollama on your machine and configure it as an OpenAI-compatible endpoint. Nothing leaves your computer.
If you don't want to manage keys: Coeus Cloud is the hosted option. Sign up and it works.
Setting up a provider
Pick your provider and follow the setup guide:
Switching providers
The provider selector is in the chat bar. You can switch between any providers you've configured at any time. The conversation history carries over.
Multiple providers
You can configure as many providers as you want and switch between them. Settings → AI Providers shows all of them.