# API Key Management

Creates, lists, rotates and revokes API keys and manages provider OAuth flows.

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

## Install

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

## Description

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

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

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>`
- `--model-access-mode <mode>`
- `--unrestricted`

**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:**

The rest: https://github.com/cheaper-inference/OmniRoute/blob/HEAD/skills/cli-keys/SKILL.md