Cli Contexts

---
name: cli-contexts
description: Manage context engineering configurations, RTK filter sets, and conversation sessions from the CLI. Apply context-relay settings and inspect active context pipelines.
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

Manage context engineering configurations, RTK filter sets, and conversation sessions from the CLI. Apply context-relay settings and inspect active context pipelines.

## Quick install

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

## Subcommands

### `context-eng`

**Example:**

```bash
omniroute context-eng
```

### `context-eng analytics`

**Flags:**

- `--period <p>`

**Example:**

```bash
omniroute context-eng analytics
```

### `context-eng caveman`

**Example:**

```bash
omniroute context-eng caveman
```

### `context-eng config`

**Example:**

```bash
omniroute context-eng config
```

### `context-eng show`

**Example:**

```bash
omniroute context-eng show
```

### `context-eng set`

**Flags:**

- `--aggressiveness <n>`
- `--max-shrink-pct <n>`
- `--preserve-tags <list>`

**Example:**

```bash
omniroute context-eng set
```

### `context-eng rtk`

**Example:**

```bash
omniroute context-eng rtk
```

### `context-eng config`

**Example:**

```bash
omniroute context-eng config
```

### `context-eng show`

**Example:**

```bash
omniroute context-eng show
```

### `context-eng set`

**Flags:**

- `--token-budget <n>`
- `--reserve-pct <n>`

**Example:**

```bash
omniroute context-eng set
```

### `context-eng filters`

**Example:**

```bash
omniroute context-eng filters
```

### `context-eng list`

**Example:**

```bash
omniroute context-eng list
```

### `context-eng add`

**Flags:**

- `--pattern <p>`
- `--priority <n>`
- `--action <a>`

**Example:**

```bash
omniroute context-eng add
```

### `context-eng remove <id>`

**Flags:**

- `--yes`

**Example:**

```bash
omniroute context-eng remove <id>
```

### `context-eng test`

**Flags:**

- `--file <path>`

**Example:**

```bash
omniroute context-eng test
```

### `context-eng raw-output <id>`

**Example:**

```bash
omniroute context-eng raw-output <id>
```

### `context-eng combos`

**Example:**

```bash
omniroute context-eng combos
```

### `context-eng list`

**Example:**

```bash
omniroute context-eng list
```

### `context-eng get <id>`

**Example:**

```bash
omniroute context-eng get <id>
```

### `context-eng assignments <id>`

**Example:**

```bash
omniroute context-eng assignments <id>
```

### `contexts`

**Example:**

```bash
omniroute contexts
```

### `contexts list`

List all contexts

**Example:**

```bash
omniroute contexts list
```

### `contexts add <name>`

Add a new context

**Flags:**

- `--url <u>`
- `--api-key <k>`
- `--api-key-stdin`
- `--access-token <t>`
- `--access-token-stdin`
- `--scope <s>`
- `--description <d>`

**Example:**

```bash
omniroute contexts add <name>
```

### `contexts use <name>`

Switch active context

**Example:**

```bash
omniroute contexts use <name>
```

### `contexts current`

Show the active context (server, auth, scope)

**Flags:**

- `--name-only`

**Example:**

```bash
omniroute contexts current
```

### `contexts show <name>`

Show context details

**Example:**

```bash
omniroute contexts show <name>
```

### `contexts remove <name>`

Remove a context

**Flags:**

- `--yes`

**Example:**

```bash
omniroute contexts remove <name>
```

### `contexts rename <old> <new>`

Rename a context

**Example:**

```bash
omniroute contexts rename <old> <new>
```

### `contexts export`

Export contexts to JSON

**Flags:**

- `--out <path>`
- `--no-secrets`
- `--include-secrets`

**Example:**

```bash
omniroute contexts export
```

### `contexts import <file>`

Import contexts from a JSON file

**Flags:**

- `--merge`

**Example:**

```bash
omniroute contexts import <file>
```

### `contexts migrate`

Move legacy plaintext context credentials to the OS keychain

**Flags:**

- `--yes`

**Example:**

```bash
omniroute contexts migrate
```

### `sessions`

**Example:**

```bash
omniroute sessions
```

### `sessions list`

**Flags:**

- `--user <u>`
- `--kind <k>`
- `--active`
- `--limit <n>`

**Example:**

```bash
omniroute sessions list
```

### `sessions show <sessionId>`

**Example:**

```bash
omniroute sessions show <sessionId>
```

### `sessions expire <sessionId>`

**Flags:**

- `--yes`

**Example:**

```bash
omniroute sessions expire <sessionId>
```

### `sessions expire-all`

**Flags:**

- `--user <u>`
- `--yes`

**Example:**

```bash
omniroute sessions expire-all
```

### `sessions current`

**Example:**

```bash
omniroute sessions current
```