claudegoodies
CLAUDE.md

OmniRoute CLAUDE.md

From diegosouzapw

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Routes chat/completions across 250 LLM providers via one API with fallback, combo strategies, MCP server, and A2A protocol support.

Use it when

  • Need one endpoint that proxies to 250 different LLM providers
  • Want automatic fallback, circuit breakers, or fusion/panel-judge routing
  • Building on Next.js and want an MCP server with 94 tools exposed
  • Need format translation between OpenAI, Claude, and Gemini APIs

Skip it if

  • Large monorepo (Next.js 16, Electron, SQLite with 110 migrations) — not a lightweight drop-in
  • Requires understanding 18 combo routing strategies and a 3-layer resilience system
  • Tied to specific stack: Next.js App Router, SQLite domain modules, Zod validation

Facts

Repository
diegosouzapw/OmniRoute
Status
Actively maintained
Last commit
Source file
CLAUDE.md

Source preview

The instructions Claude Code reads when this claude.md runs.

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Quick Start

```bash
npm install                    # Install deps (auto-generates .env from .env.example)
npm run dev                    # Dev server at http://localhost:20128
npm run build                  # Production build (Next.js 16 standalone)
npm run lint                   # ESLint (0 errors expected; warnings are pre-existing)
npm run typecheck:core         # TypeScript check (should be clean)
npm run typecheck:noimplicit:core  # Strict check (no implicit any)
npm run test:coverage          # Unit tests + coverage gate (60/60/60/60 — statements/lines/functions/branches)
npm run check                  # lint + test combined
npm run check:cycles           # Detect circular dependencies
```

### Running Tests

```bash
# Single test file (Node.js native test runner — most tests)
node --import tsx/esm --test tests/unit/your-file.test.ts

# Vitest (MCP server, autoCombo, cache)
npm run test:vitest

# All suites
npm run test:all
```

For full test matrix, see `CONTRIBUTING.md` → "Running Tests". For deep architecture, see `AGENTS.md`.

---

## Project at a Glance

**OmniRoute** — unified AI proxy/router. One endpoint, 250 LLM providers, auto-fallback.

| Layer         | Location                | Purpose
View full source on GitHub →

Other claude.md files