Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

cli-health — Claude Code skill: what it does, how to install

Checks server health, component statuses, and metrics for OmniRoute via the CLI. It tracks circuit breakers and provider availability directly in the terminal.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add cheaper-inference/OmniRoute --skill cli-health -a claude-code
Open on GitHub

What cli-health does

This skill provides commands to diagnose and monitor an OmniRoute instance. From the command line, you can test server liveness, track component failures, and inspect runtime metrics.

It wraps the omniroute CLI utility. The doctor command verifies host availability, health outputs status reports with flags like --json and --alerts-only, and health components lists individual subsystems. For continuous updates, health watch provides a dashboard with an --interval parameter.

Running these checks requires the omniroute package installed via npm or executed with npx. Without the underlying CLI tool installed, the agent cannot execute health checks.

What it helps with

  • check server liveness using omniroute doctor
  • inspect circuit breaker and provider status
  • monitor live metrics continuously with health watch
  • export health alerts in JSON format

Example prompts for the agent

  • Run omniroute health --alerts-only to check for issues
  • Verify server status using omniroute doctor --host <host>
  • Start the live dashboard with omniroute health watch

How to install cli-health

1Skills CLI (Vercel)

npx skills add cheaper-inference/OmniRoute --skill cli-health -a claude-code

2Manually: put the files in place

~/.claude/skills/cli-health/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cli-health/

From the same set34

The whole set →
cli-setup cheaper-inference Helps the agent configure OmniRoute, manage autostart, apply CLI updates, and adjust session environment variables. Claude Code CX Codex Cursor +1 1,200installs omni-combos-routing cheaper-inference This skill creates and manages model routing combos with fallback chains, tests, and metrics. Use it when OmniRoute needs configurable provider routing. Claude Code CX Codex Cursor +1 1,200installs omni-inference cheaper-inference Connects OpenAI-compatible inference endpoints for chat, embeddings, audio, and images. Useful for AI agents calling OmniRoute endpoints. Claude Code CX Codex Cursor +1 1,100installs cli-providers cheaper-inference Manage OmniRoute provider connections from the CLI: inspect the catalog, test connections, rotate keys, and view metrics. Useful when provider setup is part of your terminal workflow. Claude Code CX Codex Cursor +1 1,100installs omni-auth cheaper-inference Manage API keys and sessions in OmniRoute. Authenticates requests via Bearer tokens, handles dashboard login with password or OIDC, and controls session access. Claude Code CX Codex Cursor +1 1,100installs cli-routing cheaper-inference Manage model routing combos from the command line with omniroute. Test routing strategies, inspect metrics, and configure fallback chains interactively. Claude Code CX Codex Cursor +1 1,100installs omni-mcp cheaper-inference Connects an agent to the OmniRoute MCP server for request routing, memory, cache, and audit work. Use it when those operations need to be available as MCP tools. Claude Code CX Codex Cursor +1 1,100installs omni-providers cheaper-inference Manages connections to 375 AI providers via REST API: adds keys, tests connections, syncs models. Claude Code CX Codex Cursor +1 1,100installs

Similar

database-optimizer https://github.com/Jeffallan Investigates slow PostgreSQL and MySQL queries, breaks down execution plans with EXPLAIN ANALYZE, and drafts indexes without table locks. Claude Code CX Codex Cursor +1 5,900installs cf-cli cloudflare Cloudflare's official CLI for the public API and Workers projects, now available in your editor. Search for commands by task description, manage DNS, storage, and deployments. Claude Code CX Codex Cursor +1 10,700installs senior-architect sickn33 A skill for designing and reviewing system architecture based on explicit requirements, tradeoffs and evidence. Helps you choose an approach by examining current state, alternatives and risks. Claude Code CX Codex Cursor +1 2,200installs wizard Matt Pocock This skill creates an interactive bash wizard for manual setup steps, CI secrets, third-party dashboards, and one-off migrations. Claude Code 553,369installs hyperframes-cli heygen-com Controls HyperFrames video workflows from the CLI: audits layouts and contrast, edits timeline clips, captures snapshots, and renders locally or in cloud runtimes. Claude Code CX Codex Cursor +1 1,200,000installs setup-pre-commit Matt Pocock This skill configures pre-commit checks for a JavaScript repository, running Prettier, type checking, and tests before each commit. Claude Code 489,289installs using-git-worktrees Jesse Vincent Prepares an isolated workspace before feature work or plan execution. It checks the repository first, then uses native worktree support or Git. Claude Code CX Codex 217,153installs finishing-a-development-branch Jesse Vincent This skill checks the test suite and guides branch completion: merge locally, open a Pull Request, or leave the work in place. Claude Code CX Codex 214,439installs

Questions about cli-health

How do I install cli-health in Claude Code?

Run npx skills add cheaper-inference/OmniRoute --skill cli-health -a claude-code.

What does the cli-health skill do?

It provides commands to monitor an OmniRoute instance, check provider status, and inspect component health directly from the terminal.

What dependencies are required to run these checks?

You need the CLI tool installed via npm install -g omniroute or available via npx omniroute.

Source text

SKILL.md · MIT 
---
name: cli-health
description: Check server health, component status, and live metrics from the CLI. Run `health`, `health components`, and `health watch` for a real-time dashboard of circuit breakers and provider status.
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

Check server health, component status, and live metrics from the CLI. Run `health`, `health components`, and `health watch` for a real-time dashboard of circuit breakers and provider status.

## Quick install

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

## Subcommands

### `doctor`

**Flags:**

- `--no-liveness`
- `--host <host>`
- `--liveness-url <url>`

**Example:**

```bash
omniroute doctor
```

### `health`

**Flags:**

- `-v, --verbose`
- `--json`
- `--alerts-only`

**Example:**

```bash
omniroute health
```

### `health components`

List health components and their status

**Flags:**

- `--alerts-only`

**Example:**

```bash
omniroute health components
```

### `health watch`

Live dashboard — refresh every N seconds

**Flags:**

- `--interval <s>`

**Example:**

```bash
omniroute health watch
```

### `status`

Show OmniRoute status dashboard

**Flags:**

- `-v, --verbose`

**Example:**

```bash
omniroute status
```

© cheaper-inference · MIT · cheaper-inference/OmniRoute

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor