Agent skill

OmniRoute Resilience CLI

by diegosouzapw in diegosouzapw/OmniRoute

Command reference for omniroute's quota and resilience commands: inspect circuit breakers, cooldowns, lockouts and quota pools, reset stuck providers and tune thresholds.

MITAuto-check passedAI & LLM Engineering

Install OmniRoute Resilience CLI

skills CLI
$ npx skills add diegosouzapw/OmniRoute --skill cli-resilience -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install diegosouzapw/OmniRoute cli-resilience --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/diegosouzapw/OmniRoute.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cli-resilience .claude/skills/cli-resilience && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cli-resilience
GitHub stars
74k
Token cost
~624 tokens
SKILL.md length
144 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

Command reference for omniroute's quota and resilience commands: inspect circuit breakers, cooldowns, lockouts and quota pools, reset stuck providers and tune thresholds.

  • Finding out why a provider is being skipped because of a tripped breaker or cooldown
  • SKILL.md covers Overview, Quick install and Subcommands
  • Calls npm
  • Resetting a stuck provider or connection after the upstream issue is fixed

What it does

Quota commands show the gateway's quota, pool and circuit state, preview how allocation would be enforced without making an upstream request (by API key ID, pool ID and token count), and create or update a quota pool idempotently from a JSON object. The resilience group then lists overall status, circuit breakers, connection cooldowns and model lockouts, each filterable by provider and in some cases by connection or model.

When a provider is stuck, the reset command clears its state for a provider, connection or model, can clear all cooldowns and has a confirmation switch. Profile, show, set and config commands view and change the resilience settings, including a failure threshold, a reset timeout and a base cooldown, both given in milliseconds. The CLI is installed from npm.

When your agent uses it

  • Finding out why a provider is being skipped because of a tripped breaker or cooldown
  • Resetting a stuck provider or connection after the upstream issue is fixed
  • Previewing quota enforcement for an API key before sending real traffic
  • Adjusting the failure threshold and cooldown timings of the gateway

Example prompts

  • “Show the omniroute circuit breakers and cooldowns for the anthropic provider.”
  • “Reset all omniroute cooldowns for my openai connection, then confirm the status is clean.”
  • “Preview what quota enforcement would do for a large request on the main pool without calling upstream.”

Requirements

  • The omniroute CLI, installed with npm or run through npx

What it can do on your machine

Read from SKILL.md and the folder at commit 8ad6b1c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

OmniRoute Resilience CLI loads about 624 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 144 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~624

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from diegosouzapw/OmniRoute at commit 8ad6b1c, republished under its MIT licence (© diegosouzapw). 144 words, ~624 tokens.

Download SKILL.mdSave it as .claude/skills/cli-resilience/SKILL.md (or your agent's skills folder).
name
cli-resilience
description
Inspect and manage circuit-breaker states, connection cooldowns, quota limits, and backoff levels from the CLI. Reset stuck providers and configure resilience thresholds.
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

Overview

Inspect and manage circuit-breaker states, connection cooldowns, quota limits, and backoff levels from the CLI. Reset stuck providers and configure resilience thresholds.

Quick install

bash
npm install -g omniroute   # or: npx omniroute
omniroute --version

Subcommands

quota

Flags:

  • --provider <id>
  • --json

Example:

bash
omniroute quota
quota status

Show truthful OmniRoute gateway, quota, pool, and circuit state

Example:

bash
omniroute quota status
quota preview

Preview allocation enforcement without an upstream request

Flags:

  • --api-key-id <id>
  • --pool-id <id>
  • --tokens <n>

Example:

bash
omniroute quota preview
quota ensure <json>

Idempotently create or update a quota pool from a JSON object

Example:

bash
omniroute quota ensure <json>
resilience

Example:

bash
omniroute resilience
resilience status

Flags:

  • --provider <p>

Example:

bash
omniroute resilience status
resilience breakers

Flags:

  • --provider <p>

Example:

bash
omniroute resilience breakers
resilience cooldowns

Flags:

  • --provider <p>
  • --connection-id <id>

Example:

bash
omniroute resilience cooldowns
resilience lockouts

Flags:

  • --provider <p>
  • --model <m>

Example:

bash
omniroute resilience lockouts
resilience reset

Flags:

  • --provider <p>
  • --connection-id <id>
  • --model <m>
  • --all-cooldowns
  • --yes

Example:

bash
omniroute resilience reset
resilience profile

Example:

bash
omniroute resilience profile
resilience show

Example:

bash
omniroute resilience show
resilience set <name>

Example:

bash
omniroute resilience set <name>
resilience config

Example:

bash
omniroute resilience config
resilience show

Example:

bash
omniroute resilience show
resilience set

Flags:

  • --threshold <n>
  • --reset-timeout <ms>
  • --base-cooldown <ms>

Example:

bash
omniroute resilience set

© diegosouzapw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/cli-resilience of diegosouzapw/OmniRoute.

Open the folder on GitHubat commit 8ad6b1c

Compare with similar skills

OmniRoute Resilience CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

OmniRoute Resilience CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OmniRoute Resilience CLI this skilldiegosouzapw/OmniRoute74k—~624Automated safety check: PassMIT
Areno Debug RuntimeinclusionAI/AReno323—~486Automated safety check: PassApache-2.0
Fastllm Modelsazrtydxb/Fastllm-proxy108—~1.8kAutomated safety check: PassApache-2.0
Olore Tensorzero Latestolorehq/olore103—~1.6kAutomated safety check: PassMIT
Apex Host Workflow Startjonathan-vella/apex217—~538Automated safety check: PassMIT
Run Bitrouter Benchmarkbitrouter/bitrouter235—~2.2kAutomated safety check: PassApache-2.0

Similar skills

  • Areno Debug Runtime

    inclusionAI/AReno

    Diagnose failed, hung, slow, OOM, NaN, illegal-memory-access, NCCL, compilation, rollout, or training runs in AReno.

    323 GitHub stars~486 tokensUpdated 13 days ago
    AI & LLM EngineeringAuto-check passed
  • Fastllm Models

    azrtydxb/Fastllm-proxy

    Register and maintain the models FastLLM can serve — create, patch or delete a model, attach backends to it, remove a backend, and set the deployment-wide fallback model.

    108 GitHub stars~1.8k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Local TensorZero documentation reference (latest). An agent skill from olorehq/olore.

    103 GitHub stars~1.6k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Apex Host Workflow Start

    jonathan-vella/apex

    Start or resume an APEX workflow or named step in Agent Host after manual owner selection.

    217 GitHub stars~538 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Run Bitrouter Benchmark

    bitrouter/bitrouter

    A skill your agent uses when a user wants to run, compare, resume, audit, share, or submit a Harbor benchmark through BitRouter, including choosing a Harbor dataset and agent, confirming routed…

    235 GitHub stars~2.2k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Subzeroclaw Use

    genlayerlabs/subzeroclaw

    Run and operate SubZeroClaw — the ~550-line C agentic daemon (skill.md + LLM + shell + loop).

    137 GitHub stars~1.5k tokensUpdated 12 days ago
    AI & LLM EngineeringAuto-check passed

More from diegosouzapw/OmniRoute

All 50 skills in this repo
  • OmniRoute Backup and Sync CLI

    diegosouzapw/OmniRoute

    Backup and restore OmniRoute data from the CLI. Trigger incremental snapshots, sync to cloud storage, manage backup schedules, and restore from archive files.

    74k GitHub stars~948 tokensUpdated today
    Auto-check passed
  • OmniRoute Settings API

    diegosouzapw/OmniRoute

    Read and update global application settings: system prompts, thinking budget, IP filters, payload rules, combo defaults, and require-login configuration.

    74k GitHub starsUsed in 1 repo~3.6k tokens
    Auto-check passed
  • Quality Scan

    diegosouzapw/OmniRoute

    Runs a scoped, read-only quality scan on a repository candidate and reports exact evidence, failures and frozen debt, without treating a static scan as release acceptance.

    74k GitHub stars~748 tokensUpdated today
    Auto-check passed
  • OmniRoute Database Backups

    diegosouzapw/OmniRoute

    Trigger system backups, restore from backup files, and manage the SQLite database lifecycle. Supports export, import, and incremental snapshot strategies.

    74k GitHub starsUsed in 1 repo~395 tokens
    Auto-check passed
  • OmniRoute Provider Management

    diegosouzapw/OmniRoute

    Manages AI provider connections, API keys, OAuth flows and connection tests through OmniRoute's REST API across its 327-provider catalog.

    74k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • OmniRoute LLM Cache

    diegosouzapw/OmniRoute

    Documents OmniRoute's cache endpoints for reading cache statistics and clearing entries, statistics or the reasoning cache, with notes on TTL and similarity settings.

    74k GitHub starsUsed in 1 repo~529 tokens
    Auto-check passed

Questions about OmniRoute Resilience CLI

What does OmniRoute Resilience CLI do?

Command reference for omniroute's quota and resilience commands: inspect circuit breakers, cooldowns, lockouts and quota pools, reset stuck providers and tune thresholds. Quota commands show the gateway's quota, pool and circuit state, preview how allocation would be enforced without making an upstream request (by API key ID, pool ID and token count), and create or update a quota pool idempotently from a JSON object. The resilience group then lists overall status, circuit breakers, connection cooldowns and model lockouts, each filterable by provider and in some cases by connection or model.

When should I use OmniRoute Resilience CLI?

OmniRoute Resilience CLI fits situations like: finding out why a provider is being skipped because of a tripped breaker or cooldown; resetting a stuck provider or connection after the upstream issue is fixed; previewing quota enforcement for an API key before sending real traffic; adjusting the failure threshold and cooldown timings of the gateway.

How do I install OmniRoute Resilience CLI in Claude Code?

Run `npx skills add diegosouzapw/OmniRoute --skill cli-resilience -a claude-code`. Or copy the skill folder (skills/cli-resilience in diegosouzapw/OmniRoute) into .claude/skills/cli-resilience in your project. Claude Code loads it when a task matches its description.

How do I install OmniRoute Resilience CLI in Codex?

Run `npx skills add diegosouzapw/OmniRoute --skill cli-resilience -a codex`. Or copy the skill folder (skills/cli-resilience in diegosouzapw/OmniRoute) into .agents/skills/cli-resilience in your project. Codex loads it when a task matches its description.

Can I use OmniRoute Resilience CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add diegosouzapw/OmniRoute --skill cli-resilience -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cli-resilience, .gemini/skills/cli-resilience, .github/skills/cli-resilience and .opencode/skills/cli-resilience in your project.

What does OmniRoute Resilience CLI need to run?

Going by SKILL.md and its folder, OmniRoute Resilience CLI needs the command-line tools its instructions call (npm). Our summary lists: The omniroute CLI, installed with npm or run through npx.

Does OmniRoute Resilience CLI access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is OmniRoute Resilience CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does OmniRoute Resilience CLI use?

OmniRoute Resilience CLI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does OmniRoute Resilience CLI use?

About 624 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to OmniRoute Resilience CLI?

Skills that share tags, products or a category with OmniRoute Resilience CLI: Areno Debug Runtime (inclusionAI/AReno, 323 stars), Fastllm Models (azrtydxb/Fastllm-proxy, 108 stars), Olore Tensorzero Latest (olorehq/olore, 103 stars) and Apex Host Workflow Start (jonathan-vella/apex, 217 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OmniRoute Resilience CLI?

diegosouzapw (a GitHub user) maintains it in diegosouzapw/OmniRoute, which has 73,701 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 6, 2026.

Source: diegosouzapw/OmniRoute on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.