skills.rest
diazMelgarejo
diazMelgarejoCOMMUNITY
Explore all skills by this author →
Website𝕏@Melgarejo_yDiazGitHub

omniroute

Configure, troubleshoot, and disable the OmniRoute local AI API proxy for Claude Code.

Updated Mar 22, 2026
Search Tags:#troubleshooting#claude code#mcp#sqlite#macos#api proxy#omniroute
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill omniroute-diazmelgarejo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: omniroute
Source: https://github.com/diazMelgarejo/orama-system/tree/main/bin/orama-system/skills/omniroute
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill omniroute-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? OmniRoute, a local macOS AI API proxy, can silently break Claude Code's terminal CLI when its routing config (MCP endpoints, ANTHROPIC_BASE_URL env overrides) goes stale or the app is stopped, causing ConnectionRefused errors and failed MCP connections. This Skill provides the verified runbook to configure, reset, disable, and re-enable it safely. ## Core Features & Use Cases - MCP Endpoint Configuration: Set up the correct streamable-http MCP endpoint (http://127.0.0.1:20128/api/mcp/stream) with a registered Bearer key, avoiding dead cloud URLs and wrong transport paths. - GUI Password Reset: Reset the OmniRoute login password live by writing a bcrypt hash into storage.sqlite, with backup-first safety steps. - Disable/Re-enable Runbook: Step-by-step verified procedures to remove the env block in ~/.claude/settings.json (the actual ConnectionRefused fix), disable the LaunchAgent, back up configs, and restore everything later. - Use Case: Your terminal claude CLI fails with "Unable to connect to API (ConnectionRefused)" after OmniRoute was stopped. Use this Skill to identify the stale env block in settings.json, remove it, and verify direct Anthropic reachability. ## Quick Start Ask the AI to diagnose why the Claude Code terminal CLI cannot connect to the API and apply the OmniRoute disable procedure from this Skill.

Frequently Asked Questions about omniroute

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Claude Code ConnectionRefused errors after stopping OmniRoute?▼

Remove the env block in ~/.claude/settings.json that hard-codes ANTHROPIC_BASE_URL to the OmniRoute port and an OmniRoute auth token. Stopping the process alone is not enough because the env override still routes terminal CLI traffic to the dead port.

How do I configure the OmniRoute MCP server in Claude Code?▼

Add an http-type server entry pointing to http://127.0.0.1:20128/api/mcp/stream with an Authorization Bearer header containing a registered API key. Ensure the transport is streamable-http and harmonize global and project-scoped mcpServers entries.

How do I reset the OmniRoute GUI password?▼

Generate a bcrypt $2b$12 hash with htpasswd -B, back up storage.sqlite, then UPDATE key_value SET value for the 'password' key. Login works immediately without restarting the app.

Why does Claude Code MCP say unable to connect to OmniRoute?▼

Common causes are using the dead cloud.omniroute.online URL, calling /api/mcp/sse when transport is streamable-http, or a project-scoped config overriding the global one. Use the local /api/mcp/stream endpoint with a valid registered key.

Does disabling OmniRoute affect the Claude Desktop app?▼

No. The Desktop app injects its own ANTHROPIC_BASE_URL at launch, overriding settings.json, so it keeps working. Only the terminal CLI is affected by the stale env block.

Related Skills

Explore More Software Engineering Skills→
wfvuewfvue
3

distributing-tauri-for-macos

Create DMG installers and configure app bundles for Tauri macOS apps.

Community
Intermediate
CruxExpertsCruxExperts
3

ls-omniroute-proxy

Discover OmniRoute proxy endpoints and generate capability reports.

Community
Advanced
ClawStackStudiosClawStackStudios

scuttle-health-monitor

Monitor ShellPlate application ports and SQLite database integrity.

Community
Basic
thmtzthmtz
5

add-ollama-provider

Route NanoClaw agent groups to a local Ollama model via configuration changes.

Community
Advanced