Documentation

Setup Guide

Get Omega V1 running inside your IDE or AI client with the real local proxy URL, Omega model IDs, and Anthropic-compatible endpoints.

Drop-in Compatible Per-Key Budgets Proxy Auth Omega V1 Models

Prerequisites

Node.js 18 or newerRequired for running the Omega Plus npm setup wizard with npx.

Omega V1 API keyCreate or receive a customer API key before connecting a coding tool.

Supported coding toolClaude Code, Codex, OpenCode, Cline, Kilo Code, Factory Droid, or a manual compatible client.

If Node.js is not installed, download the official installer from nodejs.org, then reopen your terminal and run the setup command.

Quick Setup

Run the Omega Plus setup wizard, paste your API key, then choose the coding tool you want to configure.

Main Command

npx -y @kesarcloud/omega-plus-cli

Connection Values

API origin: https://omega.kesarcloud.in
Anthropic-compatible URL: https://omega.kesarcloud.in/v1
OpenAI-compatible URL: https://omega.kesarcloud.in/api/v1
API Key: YOUR_API_KEY
Primary model: omega-v1-pro
Fast model: omega-v1

Interactive Setup Flow

The wizard keeps the API key out of the shell history, detects installed tools, and writes the right config for the selected tool.

What the user sees

Omega Plus banner appears in the terminal.

User pastes the Omega API key when prompted.

Wizard validates the key and lists available coding tools.

User enters the tool number, then Omega Plus writes the config.

User opens or restarts the selected coding tool.

Claude Code CLI

Recommended: run the Omega Plus wizard and select Claude Code from the tool list. The wizard writes ~/.claude/settings.json for you.

Recommended Setup

npx -y @kesarcloud/omega-plus-cli

Optional Direct Command

npx -y @kesarcloud/omega-plus-cli configure --tool claude --api-key YOUR_API_KEY

Manual fallback: create or edit this file, then restart Claude Code.

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://omega.kesarcloud.in/v1",
    "ANTHROPIC_MODEL": "omega-v1-pro",
    "ANTHROPIC_SMALL_FAST_MODEL": "omega-v1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "hasCompletedOnboarding": true
}

OpenAI Codex CLI

Recommended: run the Omega Plus wizard and select OpenAI Codex CLI. Codex uses the OpenAI-compatible Omega endpoint.

Recommended Setup

npx -y @kesarcloud/omega-plus-cli

Optional Direct Command

npx -y @kesarcloud/omega-plus-cli configure --tool codex --api-key YOUR_API_KEY

Manual fallback: set the Omega provider in ~/.codex/config.toml, then keep the API key in ~/.codex/auth.json.

~/.codex/config.toml

model = "omega-v1-pro"
model_provider = "omega"

[model_providers.omega]
name = "Omega Plus"
base_url = "https://omega.kesarcloud.in/api/v1"
wire_api = "chat"
env_key = "OPENAI_API_KEY"

~/.codex/auth.json

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

OpenCode

Recommended: run the Omega Plus wizard and select OpenCode. The wizard writes the provider block in ~/.config/opencode/opencode.json.

Recommended Setup

npx -y @kesarcloud/omega-plus-cli

Optional Direct Command

npx -y @kesarcloud/omega-plus-cli configure --tool opencode --api-key YOUR_API_KEY

Manual fallback: add the Omega Plus provider and choose the Omega model.

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omega": {
      "npm": "@ai-sdk/anthropic",
      "name": "Omega Plus",
      "options": {
        "baseURL": "https://omega.kesarcloud.in/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "omega-v1-pro": { "name": "Omega V1 Pro" },
        "omega-v1": { "name": "Omega V1" }
      }
    }
  }
}

Cline

Recommended: run the Omega Plus wizard and select Cline. If Cline is not installed, install the extension first, then rerun the wizard.

Recommended Setup

npx -y @kesarcloud/omega-plus-cli

Optional Direct Command

npx -y @kesarcloud/omega-plus-cli configure --tool cline --api-key YOUR_API_KEY

Manual fallback: use Anthropic-compatible mode with the Omega endpoint.

Cline Settings

{
  "actModeApiProvider": "anthropic",
  "planModeApiProvider": "anthropic",
  "anthropicBaseUrl": "https://omega.kesarcloud.in/v1",
  "anthropicModelId": "omega-v1-pro",
  "planModeAnthropicModelId": "omega-v1-pro"
}

Kilo Code

Recommended: run the Omega Plus wizard and select Kilo Code. The wizard configures Kilo with the Anthropic-compatible Omega endpoint.

Recommended Setup

npx -y @kesarcloud/omega-plus-cli

Optional Direct Command

npx -y @kesarcloud/omega-plus-cli configure --tool kilo --api-key YOUR_API_KEY

Manual fallback: add the Anthropic auth block for Omega Plus.

Kilo Auth

{
  "anthropic": {
    "type": "api-key",
    "apiKey": "YOUR_API_KEY",
    "baseUrl": "https://omega.kesarcloud.in/v1",
    "model": "omega-v1-pro"
  }
}

Factory Droid

Recommended: run the Omega Plus wizard and select Factory Droid. If Droid is missing, install it first, then rerun the wizard.

Recommended Setup

npx -y @kesarcloud/omega-plus-cli

Optional Direct Command

npx -y @kesarcloud/omega-plus-cli configure --tool droid --api-key YOUR_API_KEY

Manual fallback: add a custom Anthropic-compatible model entry.

Droid Custom Model

{
  "model": "omega-v1-pro",
  "id": "custom:OmegaPlus-0",
  "baseUrl": "https://omega.kesarcloud.in/v1",
  "apiKey": "YOUR_API_KEY",
  "displayName": "Omega V1 Pro",
  "provider": "anthropic"
}

Manual IDE Configuration

Use this section for tools that are not automated by the Omega Plus npm wizard, or when you prefer to configure a client manually.

VS Code

Use the Claude Code settings file above, then restart VS Code.

Cursor

Models > Add compatible model with Base URL https://omega.kesarcloud.in/v1 and model omega-v1-pro.

Windsurf

AI Provider settings should use https://omega.kesarcloud.in/v1 as the base URL.

Cline

Set apiProvider to anthropic and use the Omega base URL with your API key.

Roo Code

Set roo-cline.apiProvider to anthropic and use your Omega API key.

Cline settings.json

{
  "cline.apiProvider": "anthropic",
  "cline.anthropicBaseUrl": "https://omega.kesarcloud.in/v1",
  "cline.apiKey": "YOUR_API_KEY"
}

Roo Code settings.json

{
  "roo-cline.apiProvider": "anthropic",
  "roo-cline.anthropicBaseUrl": "https://omega.kesarcloud.in/v1",
  "roo-cline.apiKey": "YOUR_API_KEY"
}

Generic OpenAI-Compatible Client

OPENAI_API_KEY=YOUR_API_KEY
OPENAI_BASE_URL=https://omega.kesarcloud.in/api/v1
MODEL=omega-v1-pro

Authentication

Proxy endpoints accept API key authentication through either header. Dashboard endpoints use JWT tokens returned from the login endpoint.

Header Options

x-api-key: YOUR_API_KEY
# OR
Authorization: Bearer YOUR_API_KEY

POST/v1/messages

API Key

Messages

Create a message with Anthropic-compatible request and response shape. Set stream: true for SSE streaming.

Request

{
  "model": "omega-v1-pro",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "Hello, Omega!" }
  ],
  "stream": false
}

GET/v1/models

None

Models

List all available public Omega model IDs.

Response

{
  "data": [
    {
      "id": "omega-v1",
      "object": "model",
      "display_name": "Omega V1"
    },
    {
      "id": "omega-v1-pro",
      "object": "model",
      "display_name": "Omega V1 Pro"
    }
  ]
}

POST/v1/messages/count_tokens

API Key

Token Counting

Count tokens for a message without sending it to a provider.

Request

{
  "model": "omega-v1-pro",
  "messages": [
    { "role": "user", "content": "How many tokens is this?" }
  ]
}

POST/api/auth/login

Email + Password

Dashboard Auth

Use this route to sign in to dashboard sessions.

Request

{
  "email": "YOUR_EMAIL",
  "password": "YOUR_PASSWORD"
}

Available Models

Default

Omega V1

omega-v1

Default Omega V1 production-grade coding and work model experience.

Pro

Omega V1 Pro

omega-v1-pro

Higher-capacity Omega V1 profile for heavier coding, UI, and agentic workflows.

Build Notes

Built-in search and vision

Omega Plus does not require MCP servers or third-party tools for web search and image understanding. Omega V1 and Omega V1 Pro include built-in web search and full vision capability, so both models can work with text and image inputs directly.

Troubleshooting

Connection errors

Confirm the API server is running at https://omega.kesarcloud.in.

Model not found

Use exact model IDs from the Available Models section.

Rate limited

Your five-hour token window or RPM cap may be exhausted.

Changes not applying

Restart your IDE after any config change.

Cursor/Windsurf not routing

Make sure the base URL ends with /v1.

Documentation

Setup Guide

Get Omega V1 running inside your IDE or AI client with the real local proxy URL, Omega model IDs, and Anthropic-compatible endpoints.

Drop-in Compatible Per-Key Budgets Proxy Auth Omega V1 Models

Prerequisites

Node.js 18 or newerRequired for running the Omega Plus npm setup wizard with npx.

Omega V1 API keyCreate or receive a customer API key before connecting a coding tool.

Supported coding toolClaude Code, Codex, OpenCode, Cline, Kilo Code, Factory Droid, or a manual compatible client.

If Node.js is not installed, download the official installer from nodejs.org, then reopen your terminal and run the setup command.

Quick Setup

Run the Omega Plus setup wizard, paste your API key, then choose the coding tool you want to configure.

Main Command

npx -y @kesarcloud/omega-plus-cli

Connection Values

API origin: https://omega.kesarcloud.in
Anthropic-compatible URL: https://omega.kesarcloud.in/v1
OpenAI-compatible URL: https://omega.kesarcloud.in/api/v1
API Key: YOUR_API_KEY
Primary model: omega-v1-pro
Fast model: omega-v1

Interactive Setup Flow

The wizard keeps the API key out of the shell history, detects installed tools, and writes the right config for the selected tool.

What the user sees

Omega Plus banner appears in the terminal.

User pastes the Omega API key when prompted.

Wizard validates the key and lists available coding tools.

User enters the tool number, then Omega Plus writes the config.

User opens or restarts the selected coding tool.

Claude Code CLI

Recommended: run the Omega Plus wizard and select Claude Code from the tool list. The wizard writes ~/.claude/settings.json for you.

Recommended Setup

npx -y @kesarcloud/omega-plus-cli

Optional Direct Command

npx -y @kesarcloud/omega-plus-cli configure --tool claude --api-key YOUR_API_KEY

Manual fallback: create or edit this file, then restart Claude Code.

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://omega.kesarcloud.in/v1",
    "ANTHROPIC_MODEL": "omega-v1-pro",
    "ANTHROPIC_SMALL_FAST_MODEL": "omega-v1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "hasCompletedOnboarding": true
}

OpenAI Codex CLI

Recommended: run the Omega Plus wizard and select OpenAI Codex CLI. Codex uses the OpenAI-compatible Omega endpoint.

Recommended Setup

npx -y @kesarcloud/omega-plus-cli

Optional Direct Command

npx -y @kesarcloud/omega-plus-cli configure --tool codex --api-key YOUR_API_KEY

Manual fallback: set the Omega provider in ~/.codex/config.toml, then keep the API key in ~/.codex/auth.json.

~/.codex/config.toml

model = "omega-v1-pro"
model_provider = "omega"

[model_providers.omega]
name = "Omega Plus"
base_url = "https://omega.kesarcloud.in/api/v1"
wire_api = "chat"
env_key = "OPENAI_API_KEY"

~/.codex/auth.json

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

OpenCode

Recommended: run the Omega Plus wizard and select OpenCode. The wizard writes the provider block in ~/.config/opencode/opencode.json.

Recommended Setup

npx -y @kesarcloud/omega-plus-cli

Optional Direct Command

npx -y @kesarcloud/omega-plus-cli configure --tool opencode --api-key YOUR_API_KEY

Manual fallback: add the Omega Plus provider and choose the Omega model.

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omega": {
      "npm": "@ai-sdk/anthropic",
      "name": "Omega Plus",
      "options": {
        "baseURL": "https://omega.kesarcloud.in/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "omega-v1-pro": { "name": "Omega V1 Pro" },
        "omega-v1": { "name": "Omega V1" }
      }
    }
  }
}

Cline

Recommended: run the Omega Plus wizard and select Cline. If Cline is not installed, install the extension first, then rerun the wizard.

Recommended Setup

npx -y @kesarcloud/omega-plus-cli

Optional Direct Command

npx -y @kesarcloud/omega-plus-cli configure --tool cline --api-key YOUR_API_KEY

Manual fallback: use Anthropic-compatible mode with the Omega endpoint.

Cline Settings

{
  "actModeApiProvider": "anthropic",
  "planModeApiProvider": "anthropic",
  "anthropicBaseUrl": "https://omega.kesarcloud.in/v1",
  "anthropicModelId": "omega-v1-pro",
  "planModeAnthropicModelId": "omega-v1-pro"
}

Kilo Code

Recommended: run the Omega Plus wizard and select Kilo Code. The wizard configures Kilo with the Anthropic-compatible Omega endpoint.

Recommended Setup

npx -y @kesarcloud/omega-plus-cli

Optional Direct Command

npx -y @kesarcloud/omega-plus-cli configure --tool kilo --api-key YOUR_API_KEY

Manual fallback: add the Anthropic auth block for Omega Plus.

Kilo Auth

{
  "anthropic": {
    "type": "api-key",
    "apiKey": "YOUR_API_KEY",
    "baseUrl": "https://omega.kesarcloud.in/v1",
    "model": "omega-v1-pro"
  }
}

Factory Droid

Recommended: run the Omega Plus wizard and select Factory Droid. If Droid is missing, install it first, then rerun the wizard.

Recommended Setup

npx -y @kesarcloud/omega-plus-cli

Optional Direct Command

npx -y @kesarcloud/omega-plus-cli configure --tool droid --api-key YOUR_API_KEY

Manual fallback: add a custom Anthropic-compatible model entry.

Droid Custom Model

{
  "model": "omega-v1-pro",
  "id": "custom:OmegaPlus-0",
  "baseUrl": "https://omega.kesarcloud.in/v1",
  "apiKey": "YOUR_API_KEY",
  "displayName": "Omega V1 Pro",
  "provider": "anthropic"
}

Manual IDE Configuration

Use this section for tools that are not automated by the Omega Plus npm wizard, or when you prefer to configure a client manually.

VS Code

Use the Claude Code settings file above, then restart VS Code.

Cursor

Models > Add compatible model with Base URL https://omega.kesarcloud.in/v1 and model omega-v1-pro.

Windsurf

AI Provider settings should use https://omega.kesarcloud.in/v1 as the base URL.

Cline

Set apiProvider to anthropic and use the Omega base URL with your API key.

Roo Code

Set roo-cline.apiProvider to anthropic and use your Omega API key.

Cline settings.json

{
  "cline.apiProvider": "anthropic",
  "cline.anthropicBaseUrl": "https://omega.kesarcloud.in/v1",
  "cline.apiKey": "YOUR_API_KEY"
}

Roo Code settings.json

{
  "roo-cline.apiProvider": "anthropic",
  "roo-cline.anthropicBaseUrl": "https://omega.kesarcloud.in/v1",
  "roo-cline.apiKey": "YOUR_API_KEY"
}

Generic OpenAI-Compatible Client

OPENAI_API_KEY=YOUR_API_KEY
OPENAI_BASE_URL=https://omega.kesarcloud.in/api/v1
MODEL=omega-v1-pro

Authentication

Proxy endpoints accept API key authentication through either header. Dashboard endpoints use JWT tokens returned from the login endpoint.

Header Options

x-api-key: YOUR_API_KEY
# OR
Authorization: Bearer YOUR_API_KEY

POST/v1/messages

API Key

Messages

Create a message with Anthropic-compatible request and response shape. Set stream: true for SSE streaming.

Request

{
  "model": "omega-v1-pro",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "Hello, Omega!" }
  ],
  "stream": false
}

GET/v1/models

None

Models

List all available public Omega model IDs.

Response

{
  "data": [
    {
      "id": "omega-v1",
      "object": "model",
      "display_name": "Omega V1"
    },
    {
      "id": "omega-v1-pro",
      "object": "model",
      "display_name": "Omega V1 Pro"
    }
  ]
}

POST/v1/messages/count_tokens

API Key

Token Counting

Count tokens for a message without sending it to a provider.

Request

{
  "model": "omega-v1-pro",
  "messages": [
    { "role": "user", "content": "How many tokens is this?" }
  ]
}

POST/api/auth/login

Email + Password

Dashboard Auth

Use this route to sign in to dashboard sessions.

Request

{
  "email": "YOUR_EMAIL",
  "password": "YOUR_PASSWORD"
}

Available Models

Default

Omega V1

omega-v1

Default Omega V1 production-grade coding and work model experience.

Pro

Omega V1 Pro

omega-v1-pro

Higher-capacity Omega V1 profile for heavier coding, UI, and agentic workflows.

Build Notes

Built-in search and vision

Troubleshooting

Connection errors

Confirm the API server is running at https://omega.kesarcloud.in.

Model not found

Use exact model IDs from the Available Models section.

Rate limited

Your five-hour token window or RPM cap may be exhausted.

Changes not applying

Restart your IDE after any config change.

Cursor/Windsurf not routing

Make sure the base URL ends with /v1.