---
name: cli-keys
description: Create, list, rotate, and revoke OmniRoute API keys from the CLI. Manage OAuth flows for provider authentication and inspect key scopes and expiration.
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

Create, list, rotate, and revoke OmniRoute API keys from the CLI. Manage OAuth flows for provider authentication and inspect key scopes and expiration.

## Quick install

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

## Subcommands

### `keys`

**Example:**

```bash
omniroute keys
```

### `keys add <provider> [apiKey]`

**Flags:**

- `--stdin`

**Example:**

```bash
omniroute keys add <provider> [apiKey]
```

### `keys list`

**Flags:**

- `--json`

**Example:**

```bash
omniroute keys list
```

### `keys remove <provider>`

**Flags:**

- `--yes`

**Example:**

```bash
omniroute keys remove <provider>
```

### `keys regenerate <id>`

**Flags:**

- `--yes`

**Example:**

```bash
omniroute keys regenerate <id>
```

### `keys revoke <id>`

**Flags:**

- `--yes`

**Example:**

```bash
omniroute keys revoke <id>
```

### `keys reveal <id>`

**Example:**

```bash
omniroute keys reveal <id>
```

### `keys usage <id>`

**Flags:**

- `--limit <n>`

**Example:**

```bash
omniroute keys usage <id>
```

### `keys policy`

**Example:**

```bash
omniroute keys policy
```

### `keys show <id>`

**Example:**

```bash
omniroute keys show <id>
```

### `keys set <id>`

**Flags:**

- `--rate-limit <n>`
- `--max-cost <n>`
- `--allowed-models <list>`

**Example:**

```bash
omniroute keys set <id>
```

### `keys expiration`

**Example:**

```bash
omniroute keys expiration
```

### `keys list`

**Flags:**

- `--days <n>`
- `--json`

**Example:**

```bash
omniroute keys list
```

### `keys rotate <id>`

**Flags:**

- `--grace-period <ms>`
- `--yes`

**Example:**

```bash
omniroute keys rotate <id>
```

### `oauth`

**Example:**

```bash
omniroute oauth
```

### `oauth providers`

**Example:**

```bash
omniroute oauth providers
```

### `oauth start`

**Flags:**

- `--no-browser`
- `--import-from-system`
- `--social <s>`
- `--timeout <ms>`

**Example:**

```bash
omniroute oauth start
```

### `oauth status`

**Flags:**

- `--provider <id>`

**Example:**

```bash
omniroute oauth status
```

### `oauth revoke`

**Flags:**

- `--connection-id <id>`
- `--yes`

**Example:**

```bash
omniroute oauth revoke
```