One-line description for every directory and root file. Last updated: 2026-05-13 — OmniRoute v3.8.0

---

README.md	)
CHANGELOG.md	skill)
LICENSE
CLAUDE.md
AGENTS.md
GEMINI.md
CONTRIBUTING.md
SECURITY.md
CODE_OF_CONDUCT.md
llm.txt
Tuto_Qdrant.md	integration currently dormant (see banner; primary memory docs in )
package.json
package-lock.json
tsconfig.json
tsconfig.typecheck-core.json	core
tsconfig.typecheck-noimplicit-core.json	) typecheck
tsconfig.tsbuildinfo
next.config.mjs
next-env.d.ts
eslint.config.mjs
prettier.config.mjs
postcss.config.mjs
playwright.config.ts
vitest.config.ts
vitest.mcp.config.ts
sonar-project.properties
Dockerfile
docker-compose.yml
docker-compose.prod.yml
.dockerignore
fly.toml	, port 20128, /data volume)
.env.example	on first install)
.gitignore
.npmignore
.npmrc
.node-version
.nvmrc

---

— Next.js application

— App Router (Next.js 16)

(non-v1)
	)
	)
, ,
, , , , ,
, , ,
, , ,

— Core libraries (~50 modules)

	)
	, validation)
	)
,
,
,
,

— Database (45+ modules + 55 migrations)

	singleton with WAL journaling
	..)
	log, webhooks, skills, memory_entries, cloud_agent_tasks, evals*, reasoning_cache, etc.

	)

	→ → — see

	177 providers with Zod validation (source of truth)
	14 routing strategies with priorities
	, etc.)
	in )
	)

---

— Streaming Engine Workspace

). Handles request processing + provider execution.

	, )
	table
	)

---

— Desktop Wrapper

	)
	)

---

— CLI

	, , , , , etc.
	— pre-resolves drivers at postinstall / first startup

---

— Public Agent Skills

---

— Build & Check Scripts

	from on first install
	keys with
	budget per file
	vs
	from catalog
	from
	) match Electron's Node
	endpoint

---

— Public Documentation (44 files + 4 subdirs)

	)
	Auto-generated catalog of 177 providers (regen: )

	→ → )

	— superseded by EVALS)
	skill)

---

— Test Suites

---

— Static Assets

(root)

---

— Static Configs

---

— GitHub Integration

---

— Git Hooks

	manually.

---

— Claude Code Slash Commands

	— bump version + auto-changelog
	— full release workflow

---

— Generic Agent Workflows (Codex / Cursor / etc.)

	)

Note: Workflows and commands are currently identical byte-by-byte. If is meant to target a different agent runtime (Codex), the variants need to diverge meaningfully.

---

, , , — Out-of-tree

— design notes (defer / notfit / viable categories)
• — historic subprojects (omnirouteCloud, omnirouteSite, vscode-extension)
• — read-only clones of related OSS projects (LiteLLM, 9router, ClawRouter, CLIProxyAPI, modelrelay, new-api, etc.) for cross-reference during development
• — per-release task tracking files (informal)

output. See .

---

---

New contributor? Read → → → .
• Adding a provider? Follow + cross-check .
• Adding a route? + .
• Adding an MCP tool? .
• Adding an A2A skill? .
• Running locally? .
• Deploying? / / .
• Releasing? (and Claude Code skill).