---
name: cli-models
description: Query available AI models, list model aliases, and browse the full model catalog from the CLI. Filter by provider, search by capability, and resolve model name variants.
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

Query available AI models, list model aliases, and browse the full model catalog from the CLI. Filter by provider, search by capability, and resolve model name variants.

## Quick install

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

## Subcommands

### `models test-add <model>`

Validate an OpenAI-compatible model on one strict connection, then add it after a synthetic tool round-trip

**Flags:**

- `--provider <id>`
- `--connection <id>`
- `--name <name>`
- `--max-input-tokens <count>`
- `--max-output-tokens <count>`
- `--api-format <format>`
- `--context <name>`
- `--base-url <url>`
- `--allow-inference`
- `--yes`
- `--dry-run`
- `--json`

**Example:**

```bash
omniroute models test-add example-model --provider example-provider --connection example-connection --dry-run
```

### `models [provider]`

**Flags:**

- `--search <query>`
- `--json`

**Example:**

```bash
omniroute models [provider]
```

### `models manual <provider>`

List manual model metadata from the selected server

**Example:**

```bash
omniroute models manual <provider>
```

### `models add <provider> <model-id>`

Add an unverified manual model, then verify persistence

**Flags:**

- `--name <name>`
- `--api-format <format>`
- `--context-window <tokens>`
- `--max-output-tokens <tokens>`
- `--dry-run`

**Example:**

```bash
omniroute models add <provider> <model-id>
```

### `models edit <provider> <model-id>`

Edit manual model metadata, then verify persistence

**Flags:**

- `--name <name>`
- `--api-format <format>`
- `--context-window <tokens>`
- `--clear-context-window`
- `--dry-run`

**Example:**

```bash
omniroute models edit <provider> <model-id>
```

### `models remove <provider> <model-id>`

Remove only a manual model override, then verify persistence

**Flags:**

- `--yes`
- `--dry-run`

**Example:**

```bash
omniroute models remove <provider> <model-id>
```