Configuring AI

Octarine can use cloud APIs, local model servers, and supported assistant accounts for the Writing Assistant and Ask Octarine.

Accounts and API Providers

The AI section in Settings separates two kinds of connections:

Settings page	Use it for
AI → Accounts	Assistant subscriptions or local account sessions that do not require pasting a provider API key into Octarine. Codex is available; Claude account support is marked Coming soon.
AI → API Providers	Cloud API keys, Ollama, LM Studio, and custom OpenAI- or Anthropic-compatible endpoints.

Account and provider choices are configured per workspace. You can copy them when creating a workspace with Use settings from an existing workspace.

Connect a Codex Account

Open Settings → AI → Accounts → Codex. Octarine uses the local Codex CLI session, so it does not ask you to paste a separate key. See Working with Codex for installation, sign-in, and troubleshooting.

Claude subscription accounts appear on the Accounts page but are not available yet. To use Claude models today, configure the Anthropic API provider with an API key.

Configure a Built-In API Provider

Open Settings → AI → API Providers, select a provider, enter the required API key or local server URL, and activate the connection. API-key providers validate the key and show a checkmark once connected.

Built-in API Providers include:

• OpenAI
• Anthropic
• DeepSeek
• Google Gemini
• Groq
• Mistral AI
• Perplexity
• Together AI
• xAI
• Ollama
• LM Studio

Ollama and LM Studio use a local server URL instead of a cloud API key. Follow the dedicated Ollama and LM Studio guides to start those servers.

Custom Providers

Choose New Custom Provider on the API Providers page when your service exposes an OpenAI- or Anthropic-compatible API.

1. Choose the OpenAI or Anthropic API format.
2. Give the provider a name.
3. Enter its base URL without a trailing slash.
4. Add an API key. A key is optional only when the URL begins with http://; HTTPS endpoints require one.
5. Save the provider. Octarine checks its models endpoint before adding it.

For the OpenAI format, enter the versioned API base that sits directly before /models and /chat/completions, such as https://openrouter.ai/api/v1. For the Anthropic format, enter the root before /v1/models and /v1/messages, such as https://api.anthropic.com.

Saved endpoints appear under Custom. Select one there to edit its name, URL, format, or key, or to delete it.

Selecting a Model

After a connection is configured, its available models appear in the model selector in the Writing Assistant and Ask Octarine.

• Models are grouped by account or provider.
• You can change models between prompts or during a conversation.
• Octarine remembers the selected provider and model in the workspace settings.
• Capabilities such as tools and web search depend on the selected model and provider.

Rules, Skills, and Slash Commands

AI Settings also includes three ways to reuse instructions:

• Rules are workspace-wide standing instructions automatically included with Writing Assistant requests.
• Skills are Markdown instruction files that you explicitly attach to a Writing Assistant or Ask Octarine prompt.
• Slash Commands insert reusable prompt text in the Writing Assistant.

Privacy and Storage

API keys, provider URLs, selected models, and Rules are stored in the device-specific Octarine settings file. They are outside the workspace and are not synced by Git or cloud-folder sync. Custom Skills and Slash Commands are stored inside .octarine in the workspace and can sync with it.

When you use a cloud provider, Octarine sends the prompt and included note context to that provider. Use Ollama, LM Studio, or another local endpoint if you want model requests to remain on your own computer.

Quick Answers