Omega Plus CLI

Interactive setup wizard for connecting local coding tools to Omega Plus.

npx -y @kesarcloud/omega-plus-cli@latest

Always keep the explicit @latest tag. npm resolves the current dist-tag before executing, while its content-addressed cache can still safely reuse files for that exact version. The startup logo prints the running CLI version so support can immediately confirm which release generated a config.

The wizard shows the Omega Plus banner, validates your Omega API key, lets you choose a supported coding tool, backs up existing config files, and writes Omega Plus settings.

Supported Tools

• Claude Code
• OpenAI Codex CLI
• OpenCode
• Cline
• Kilo Code
• Factory Droid

Non-Interactive Usage

npx -y @kesarcloud/omega-plus-cli@latest configure --tool claude --api-key YOUR_KEY
npx -y @kesarcloud/omega-plus-cli@latest configure --tool codex --api-key YOUR_KEY --dry-run
npx -y @kesarcloud/omega-plus-cli@latest update
npx -y @kesarcloud/omega-plus-cli@latest update --tool claude
npx -y @kesarcloud/omega-plus-cli@latest update --tool claude --model claude-sonnet-5
npx -y @kesarcloud/omega-plus-cli@latest update --tool opencode --model gpt-5.6-sol --fast-model quantum-lite-1

Defaults:

• Base URL: https://api.omegaplusapi.com/v1
• OpenAI-compatible URL: https://api.omegaplusapi.com/api/v1
• Anthropic-compatible URL: https://api.omegaplusapi.com/v1
• API key validation URL: https://api.omegaplusapi.com/api/omega/validate-key
• Model: omega-plus
• Fast model: omega-plus
• All 16 Omega Plus models are included in generated configs and Claude Code gateway discovery.

The current primary and fast model selections are preserved by update. Pass --model or --fast-model only when you intentionally want to switch them. The latest catalog includes Claude Sonnet 5, GPT-5.6 Sol, Claude Opus 5, and Quantum Lite 1; each supports native vision, a 1,000,000-token context window, and up to 128,000 output tokens.

Running setup again with @latest rewrites the selected tool's Omega-managed catalog and endpoint fields from the current release, while preserving unrelated settings and creating backups. Existing users can refresh every configured tool in one pass with:

npx -y @kesarcloud/omega-plus-cli@latest update

Use --base-url, --openai-base-url, --anthropic-base-url, --model, or --fast-model to override them.

Codex receives the OpenAI-compatible endpoint. Claude Code, OpenCode, Cline, Kilo Code, and Factory Droid receive the Anthropic-compatible endpoint. The CLI validates the key before writing configs; use --skip-key-validation only for local testing or dry runs against an unavailable server.

Installation and config discovery

The setup wizard detects tools installed through npm, native/curl installers, Bun, pnpm, Volta, WinGet, custom npm prefixes, and standard per-user binary directories. Tool installation paths and configuration paths are resolved independently.

For the selected tool, Omega Plus updates the active user config plus any existing alternate user-level configs discovered through USERPROFILE, HOME, XDG, or legacy locations. Every existing file is backed up and read back before success is reported. CLAUDE_CONFIG_DIR, CODEX_HOME, OPENCODE_CONFIG, and OPENCODE_CONFIG_DIR are honored. Project-local configs are never modified because they may be committed to source control and must not receive API keys.