Skip to content

cyborgateuk-arch/OmniCode

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

OmniCode β€” AI Coding, Built for Developers

OmniCode

The AI-Native IDE with a Built-In Provider Control Center.
Connect 169+ AI providers. Route across free & paid models. Zero config.

License: MIT Release Stars Issues Pull Requests TypeScript Electron Node.js Platform

πŸš€ Quick Start β€’ πŸ”Œ Providers β€’ 🎯 Combos β€’ πŸ“Š Cost Savings β€’ πŸ›‘οΈ OmniProxy β€’ πŸ“Έ Screenshots β€’ πŸ“– Docs

πŸ’₯ The Promise β€’ πŸ€” Why β€’ πŸ† What Sets Apart β€’ πŸ”’ Security β€’ πŸ—οΈ Architecture β€’ 🀝 Contributing


πŸ’₯ The Promise

One IDE. 169+ providers. Every AI model you need β€” and a free coding agent that never stops.

OmniCode is an intelligent development environment that centralizes and streamlines every AI interaction directly inside your editor. Stop juggling browser dashboards, dead API keys, and surprise bills. OmniCode brings it all home.

🚫 Never hit limits πŸ’Έ $0 to start πŸ“Š Full cost visibility
Auto-fallback across providers. Quota out? Next model takes over β€” zero downtime. Free-tier OAuth providers (Kiro, Qoder, GitHub Copilot, Gemini CLI). No card needed. Real-time dashboards for token usage, per-provider costs, and model-level spend.
πŸ”Œ Every model works 🧩 One unified picker πŸ›‘οΈ Production-grade
169+ providers β€” Claude, GPT, Gemini, DeepSeek, Grok, Qwen β€” through one interface. All models synced into the native editor picker. No separate UI or fragmented experience. Semantic caching, combo routing, budget controls, PII guards, encryption at rest.

πŸ€” Why OmniCode?

Stop juggling 10 dashboards, dead API keys, and surprise bills.

❌ The daily pain βœ… How OmniCode fixes it
πŸ“‰ Subscription quota expires unused every month Maximize subscriptions β€” track quota, use every token before reset
πŸ›‘ Rate limits stop you mid-coding Auto-fallback combos β€” route to the next provider in milliseconds
πŸ’Έ Expensive APIs ($20–50/mo per provider) Free coding agent β€” route routine tasks to free-tier models at $0
🧰 Each AI tool wants its own setup One IDE, one picker β€” every model in one unified dropdown
πŸ” API keys scattered across .env files Encrypted secret storage β€” AES-256-GCM at rest, never in source control
πŸ“Š No visibility into what you're spending Cost & analytics dashboards β€” per-request, per-model, per-provider breakdowns
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚       OmniCode IDE  (Native Chat & AI Agent Interface)     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                          β”‚ Embedded OmniProxy Runtime
                          β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚              OmniProxy β€” Smart Router & Cache               β”‚
β”‚  Semantic caching Β· Combo routing Β· Budget controls         β”‚
β”‚  PII guards Β· Encrypted secrets Β· Cost analytics            β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
        β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
        β–Ό Tier 1      β–Ό Tier 2      β–Ό Tier 3       β–Ό Tier 4
   SUBSCRIPTION     API KEY        FREE TIER      CUSTOM
   Claude Code,     OpenAI,        Kiro, Qoder,   Local LLMs,
   Codex, Copilot   DeepSeek       Gemini CLI     Ollama
   quota out? ───▢  budget hit? ─▢ always on ──▢  your server

🎯 Combos β€” Multi-Model Routing

A Combo is a chain of models OmniCode routes across automatically. Quota runs out, a provider fails, or costs spike β€” the combo silently slides to the next model. This is what makes OmniCode unbreakable. πŸ›‘οΈ

⚑ How it works

Configure fallback chains in the OmniProxy dashboard. OmniCode evaluates your rules in real-time:

Combo: "always-on-coding"                    Strategy: priority
  1. cc/claude-opus-4-7      ← OAuth subscription (use it fully)
  2. cx/gpt-5.5              ← Codex OAuth (second subscription)
  3. kr/claude-sonnet-4.6    ← Kiro FREE (unlimited Claude)
  4. qoder/deepseek-v3.2     ← Qoder FREE (always available)
Result: 4 layers of fallback = zero downtime

πŸ”€ Routing strategies

Goal Strategy
πŸ₯‡ Drain my subscription before paying Priority / Fill-first
βš–οΈ Spread load across accounts Round-robin
πŸ’Έ Always cheapest viable model Cost-optimized
🧠 Best model for complex reasoning Premium escalation
πŸ†“ Free-first for routine tasks Free agent routing

🧱 Resilience is built in

Layer Scope What it does
πŸ”Œ Circuit breaker Whole provider Stops hammering a failing provider; auto-probes to recover
πŸ’€ Connection cooldown One account/key Skips a rate-limited key while others keep serving
πŸ’Ύ Semantic cache Identical prompts Returns cached response instantly β€” cost: $0, latency: ~0ms

πŸ† What Sets OmniCode Apart

Feature OmniCode Traditional IDEs Other AI Tools
πŸ”Œ Built-in AI providers 169+ (OAuth + API key) 1–2 External only
πŸ†“ Free-tier routing βœ… Automatic ❌ ❌
πŸ”€ Multi-model combos βœ… Configurable chains ❌ Rare
πŸ“Š Cost & usage dashboards βœ… Native ❌ Separate tool
πŸ’Ύ Semantic caching βœ… Built-in ❌ Rare
🧩 Unified model picker βœ… All models, one dropdown 1 provider N/A
πŸ”— Custom endpoints βœ… Any OpenAI-compatible ❌ Limited
πŸ›‘οΈ PII & injection guards βœ… Built-in ❌ Rare
πŸ” Encrypted secret storage βœ… AES-256-GCM Plaintext .env Varies
πŸ–₯️ Full IDE experience βœ… VS Code-based editor βœ… ❌ CLI only
πŸ“¦ Batch testing βœ… Cross-model evaluation ❌ ❌
🎨 Image generation βœ… Built-in media tools ❌ Separate

πŸ”Œ 169+ AI Providers β€” Unified Model Picker

The most comprehensive provider ecosystem of any AI-native IDE. Connect via OAuth (one-click) or API key β€” all models appear instantly in the native editor picker.

πŸ” OAuth Providers (One-Click Connect)

Provider Auth Flow Models Status
Claude (Anthropic) Authorization Code + PKCE Opus 4.7, Sonnet 4.6, Haiku 4.5 βœ…
Codex (OpenAI) Authorization Code + PKCE GPT-5.5, GPT-5.4, GPT-5.3 Codex βœ…
Gemini (Google) Standard OAuth2 Synced via API (all models) βœ…
Gemini CLI Standard OAuth2 Gemini 3.1 Pro, 3 Flash, 3.1 Flash Lite βœ…
GitHub Copilot Device Code Flow GPT-5.5, Claude Opus 4.7, Gemini 3.1 Pro βœ…
Qwen (Alibaba) Device Code + PKCE Qwen3 Coder Plus/Flash, Vision βœ…
Kimi Coding (Moonshot) Device Code Flow Kimi K2.6, K2.6 Thinking βœ…
Antigravity (Google Cloud) Standard OAuth2 Passthrough models βœ…
Kiro (AWS) SSO OIDC / Social Login Claude Opus 4.7, Sonnet 4.6, Haiku 4.5 βœ…
Cursor Token Import 70+ models (GPT, Claude, Gemini, Grok) βœ…
Cline Local Callback Flow Claude, GPT, Gemini, DeepSeek, Kimi βœ…
KiloCode Custom Device Auth OpenRouter models, GPT, Claude, Gemini βœ…
GitLab Duo Authorization Code + PKCE Enterprise models βœ…
Amazon Q AWS Builder ID AWS models βœ…
Qoder AI API Key / OAuth Qwen3, Kimi K2, DeepSeek, ROME βœ…

πŸ”‘ API Key Providers

Provider Highlights
OpenAI GPT-5.5, GPT-5.4, GPT-5.4 Mini/Nano, O3
Anthropic Claude Opus 4.7, Sonnet 4.6, Haiku 4.5
DeepSeek V4 Pro, V4 Flash
Groq Llama 3.3 70B, Llama 4 Maverick, Qwen3 32B
xAI Grok 4.3, Grok 4.20 (Reasoning, Multi Agent)
Mistral Large 3, Medium 3.5, Small 4, Devstral 2
Together Llama 3.3 70B πŸ†“, DeepSeek R1 πŸ†“, Qwen3 235B
Fireworks Kimi K2.6, MiniMax M2.7, Qwen3.6 Plus
Cerebras GLM 4.7, GPT OSS 120B
Perplexity Sonar Deep Research, Reasoning Pro, Pro
Cohere Command A Reasoning, Vision
NVIDIA NIM GLM 5.1, Gemma 4, Nemotron 3 Super, DeepSeek V4
SiliconFlow DeepSeek V3.2, Qwen3 Coder 480B
OpenRouter Auto (Best Available) β€” access to 200+ models
HuggingFace Open-source model catalog
Ollama Cloud DeepSeek V4, Kimi K2.6, GLM 5.1
MiniMax M2.7, M2.5, Highspeed variants
GLM / ZAI GLM 5.1, GLM 5, GLM 5 Turbo

πŸ†“ Free Providers β€” $0, No Card

Provider What's Free Limits
Kiro AI Claude Opus 4.7, Sonnet 4.6, Haiku 4.5 OAuth, generous limits
Qoder AI Qwen3, DeepSeek, Kimi K2 Unlimited for supported models
Gemini CLI Gemini 3.1 Pro, 3 Flash 180K requests/mo free
GitHub Copilot GPT-5 Mini, Claude Haiku 4.5 Free tier available
Together AI Llama 3.3 70B, DeepSeek R1 Distill, Llama Vision Free tier models
NVIDIA NIM 13+ models ~40 RPM free
Cerebras GLM 4.7, GPT OSS 120B Free tier with limits
OpenCode GLM 5.1, Kimi K2.6, DeepSeek V4, MiMo V2.5 Free tier available

πŸ”— Custom Endpoints

Integrate any OpenAI-compatible endpoint in 3 steps:

  1. Provide a group name
  2. Supply the API key
  3. Enter the Base URL

OmniCode automatically queries the /models endpoint and populates available models into the unified picker.


πŸ“Š Cost Savings & Free Coding Agent

OmniCode is built to dramatically reduce API spend through intelligent request handling:

flowchart LR
    A[Incoming Request] --> B{Is it Cached?}
    B -- Yes --> C["Return Cached Response<br/><b>Cost: $0</b>"]
    B -- No --> D{Requires Premium AI?}
    D -- No --> E["Route to Free Agent/Tier<br/><b>Cost: $0</b>"]
    D -- Yes --> F["Route to Premium Model<br/><b>Cost: Standard API Rate</b>"]
Loading

How it saves you money

Strategy Savings How it works
πŸ’Ύ Semantic Caching 100% on cache hits Duplicate or semantically identical prompts served instantly from local cache
πŸ†“ Free Agent Routing 100% on routine tasks Standard coding queries routed to free-tier models or local endpoints
🎯 Strategic Fallbacks 50–90% Premium models reserved for complex reasoning; routine tasks use cheap providers
πŸ“‰ Quota Maximization Subscription ROI ↑ Drain your paid subscriptions fully before falling back to API-key providers

πŸ’° Real-world cost comparison

Scenario Without OmniCode With OmniCode Savings
100 routine code completions/day ~$2.50/day (paid API) $0 (free agent) $75/mo
50 repeated similar queries ~$1.25/day (paid API) $0 (semantic cache) $37/mo
Subscription quota overflow New API charges Auto-fallback to free Variable

πŸ›‘οΈ OmniProxy Native Control Center

A comprehensive, built-in management workspace embedded directly in the editor. No browser dashboards, no external tools β€” everything is native.

Section Description
🏠 Home Global runtime status, provider overview, model sync state, and proxy health
πŸ”Œ Providers Connect, test, and manage integrations for 169+ AI providers with live status cards
🎯 Combos Configure multi-model routing chains and automated fallback strategies
πŸ§ͺ Batch Testing Evaluate and test prompts across multiple models simultaneously
πŸ’° Costs Detailed tracking of token usage and financial spend per provider and model
πŸ“Š Analytics Deep dive into request patterns, latency metrics, and usage trends
πŸ’Ύ Cache Advanced semantic and prompt cache controls for optimized performance
πŸ“ Limits & Quotas Set rate limits, monitor quotas, and enforce budget controls
πŸ–ΌοΈ Media Manage image generation and rich media assets

πŸ—οΈ Architecture & How It Works

OmniCode's architecture is designed for speed, security, and seamless integration:

flowchart TD
    User([User Prompt]) --> ChatUI[Native Chat Interface]
    ChatUI --> OmniProxy{OmniProxy Router}
    
    OmniProxy -->|Check Cache| Cache[(Semantic Cache)]
    Cache -- Cache Hit --> ChatUI
    
    OmniProxy -- Cache Miss --> Evaluator{Combo / Fallback Rules}
    Evaluator -->|Free Tier| Free[Free Agent / Models]
    Evaluator -->|Premium Tier| Premium[Premium API Providers]
    Evaluator -->|Local/Custom| Custom[Custom Endpoints]
    
    Free --> ChatUI
    Premium --> ChatUI
    Custom --> ChatUI
Loading

Request flow

  1. User Interaction: You submit a prompt via the native Chat interface or AI agent in the editor.
  2. Model Selection: The editor retrieves available models from chatLanguageModels.json, continuously synced by the OmniProxy extension.
  3. Smart Routing: The request passes through the OmniRoute Extension Bridge, which evaluates active routing rules, combos, and fallbacks.
  4. Provider Execution: The Embedded Runtime securely authenticates using locally stored credentials (never committed to code) and dispatches to the appropriate provider.
  5. Response & Caching: The response streams back in real-time, with optional semantic caching applied to reduce costs and latency on future requests.

Source map

Area Path Description
πŸ“¦ Product metadata product.json Application identifiers, naming, and configuration
🎨 Resources resources/ Icon assets for macOS, Windows, Linux, and web
πŸ›‘οΈ OmniProxy Dashboard src/vs/workbench/contrib/chat/browser/omniProxyManagement/ Native management dashboard source code
βš™οΈ OmniProxy Runtime omniproxy-runtime/ Embedded Node.js backend for AI routing
πŸ”— Provider Registry omniproxy-runtime/open-sse/config/providerRegistry.ts Single source of truth for all 169+ providers
🧩 Extension Bridge extensions/omniroute/ Connects workbench UI to OmniProxy runtime
🧠 Model Discovery src/vs/workbench/contrib/chat/common/languageModels.ts Core logic for model discovery and endpoint integration

πŸ€– Personalized Coding Agent

Tailor your AI assistant to your exact workflow. Through Combos configuration in OmniProxy, you define:

  • 🎯 Custom system prompts β€” personalize the AI's behavior and tone
  • 🧠 Specialized context boundaries β€” scope the AI to your project's architecture
  • πŸ”€ Preferred model fallbacks β€” set your ideal model chain
  • πŸ”„ Hot-swap the brain β€” switch from local open-source to state-of-the-art paid models without changing your editing habits

The result: a deeply personalized coding agent that adapts to your coding style, no matter which backend AI provider is currently active.


πŸ“Έ Screenshots & Showcase

OmniProxy Dashboard β€” Home

The dashboard provides an at-a-glance view of your runtime status, connected providers, synced models, and proxy configuration.

OmniProxy Dashboard

OmniProxy Showcase

Showcase β€” Provider Cards & Model Sync Showcase β€” Cost Analytics Dashboard Showcase β€” Combo Routing Configuration Showcase β€” Batch Testing Interface Showcase β€” Cache & Quota Management


πŸš€ Quick Start

Requirements

Requirement Version
πŸ–₯️ macOS / Linux / Windows Latest stable
πŸ“¦ Node.js 22.x LTS (recommended)
πŸ“¦ npm 10.x

1) Clone & install

git clone https://github.com/cyborgateuk-arch/OmniCode.git
cd OmniCode
npm install

2) Build

npm run gulp compile
node build/next/index.ts bundle --out out --target desktop

3) Run

# macOS
open -na '.build/electron/OmniCode.app' --args '.'

# Linux
.build/electron/OmniCode --no-sandbox .

# Windows
.build\electron\OmniCode.exe .

4) Setup OmniProxy Runtime

The OmniProxy runtime handles all AI requests locally and securely. On first run:

# Navigate to the runtime directory
cd omniproxy-runtime

# Copy the example environment file
cp .env.example .env

# Generate security secrets
openssl rand -base64 48    # JWT secret
openssl rand -hex 32       # API key encryption secret

Enter your provider API keys or OAuth credentials in the .env file. The runtime automatically initializes when you open the OmniProxy dashboard in the editor.

5) Connect a FREE provider (no signup)

Open the OmniProxy Dashboard β†’ Providers β†’ Connect Kiro AI (free Claude) or Qoder AI (free Qwen/DeepSeek) β†’ done.

6) Start coding! πŸŽ‰

All connected models appear instantly in the native model picker. Select a model and start chatting.


πŸ”’ Private & Secure by Design

Your keys, your machine, your data. OmniCode is designed with a security-first architecture.

🏠 100% local πŸ” Encrypted at rest
Runs entirely on your hardware. No OmniCode cloud in the request path. API keys & OAuth tokens sealed with AES-256-GCM.
🚫 Zero telemetry by default πŸ›‘οΈ Hardened gateway
Your prompts go only to the providers you choose, nowhere else. PII sanitization, prompt-injection guards, loopback-only routes.
πŸ“œ MIT licensed πŸ”’ No secrets in source
Fully open-source β€” audit every line, self-host forever. API keys, OAuth tokens, and secrets strictly excluded from version control.

Security highlights:

  • Sensitive values managed at runtime via secure secret storage or local .env file
  • .env and generated artifacts (logs, databases) strictly ignored by version control
  • PII sanitization and prompt injection guards built into the proxy layer
  • Database encryption at rest supported

See SECURITY.md for the full security policy.


πŸ–₯️ Where OmniCode Runs β€” Anywhere

Platform Install Highlights
🍎 macOS npm install && npm run gulp compile Native .app bundle with system tray
🐧 Linux Same build pipeline AppImage / deb / rpm packages
πŸͺŸ Windows Same build pipeline Native .exe with installer
🐳 Docker docker build Headless server mode for remote development
πŸ’» From source git clone && npm install Full development setup

πŸ› οΈ Tech Stack

Component Technology
Runtime Node.js 22.x LTS
Language TypeScript 6.0 β€” 100% TypeScript across src/ and omniproxy-runtime/
Framework Electron 39.x + VS Code workbench architecture
OmniProxy Runtime Next.js 16 + React 19 + Tailwind CSS 4
Database better-sqlite3 (SQLite) + LowDB (JSON) β€” routing decisions, cache, analytics
Auth OAuth 2.0 (PKCE, Device Code, SSO OIDC) + API Keys + Encrypted Secret Storage
Streaming Server-Sent Events (SSE) for real-time model responses
Security AES-256-GCM encryption, PII sanitization, prompt injection guards
Testing Mocha + Playwright (unit, integration, E2E)
CI/CD GitHub Actions (automated builds and releases)
License MIT

πŸ“– Documentation

πŸ“˜ Getting Started

Document Description
Full OmniCode Documentation Architecture, detailed flows, and build instructions
Quick Start 6-step install β†’ connect β†’ code
Copilot Instructions Project architecture, coding guidelines, and validation steps

πŸ”§ Operations & Configuration

Document Description
Security Policy Vulnerability reporting and security practices
Contributing Guide Development setup and contribution guidelines
License MIT License

🧠 Key Source Files

File Purpose
product.json Product identifiers, naming, and application metadata
omniproxy-runtime/.env.example Complete environment variable reference
omniproxy-runtime/open-sse/config/providerRegistry.ts Single source of truth for all provider configurations
src/vs/workbench/contrib/chat/browser/omniProxyManagement/ OmniProxy dashboard implementation
extensions/omniroute/ Extension bridge connecting UI to runtime

🀝 Contributing

We welcome contributions! Whether it's bug reports, feature requests, or pull requests β€” every contribution matters.

How to contribute

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Development setup

# Clone and install
git clone https://github.com/cyborgateuk-arch/OmniCode.git
cd OmniCode
npm install

# Start development watch mode
npm run watch

# Run tests
npm run test-node

# Type-check
npm run compile-check-ts-native

See CONTRIBUTING.md for detailed guidelines.


πŸ” GitHub SEO & Discoverability

Topics & Keywords

ai-ide ai-coding ai-assistant code-editor omnicode omniproxy multi-model ai-routing free-ai developer-tools vscode-fork typescript electron llm-routing model-management ai-proxy cost-optimization semantic-caching oauth-providers coding-agent

What makes OmniCode searchable

  • AI-native IDE β€” not just a plugin, but a full editor with AI built in
  • Multi-provider routing β€” the only IDE that routes across 169+ AI providers
  • Free coding agent β€” $0 to start, with free-tier providers and semantic caching
  • Built-in dashboard β€” no external tools needed for provider management
  • Open source β€” MIT licensed, fully auditable, community-driven

πŸ“„ License

MIT License β€” free forever, open source, no restrictions.


Built with ❀️ for developers who demand more from their AI tools.

⭐ Star us on GitHub β€’ πŸ› Report a Bug β€’ πŸ’¬ Discussions