# Gateway Health Checks

Checks server health, component status and circuit breakers with a live watch view.

- Repository: https://github.com/cheaper-inference/OmniRoute (83611 stars)
- Category: DevOps
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add cheaper-inference/OmniRoute --skill cli-health -g -a claude-code -y`
Codex: `npx skills add cheaper-inference/OmniRoute --skill cli-health -g -a codex -y`
Cursor: `npx skills add cheaper-inference/OmniRoute --skill cli-health -g -a cursor -y`
Gemini CLI: `npx skills add cheaper-inference/OmniRoute --skill cli-health -g -a gemini-cli -y`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

<!-- 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
```