---
name: cli-batches
description: Submit and monitor batch inference jobs from the CLI. Upload and manage files for batch processing, retrieve results, and integrate batch pipelines with CI/CD workflows.
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

Submit and monitor batch inference jobs from the CLI. Upload and manage files for batch processing, retrieve results, and integrate batch pipelines with CI/CD workflows.

## Quick install

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

## Subcommands

### `batches`

**Example:**

```bash
omniroute batches
```

### `batches list`

**Flags:**

- `--status <s>`
- `--limit <n>`

**Example:**

```bash
omniroute batches list
```

### `batches get <batchId>`

**Example:**

```bash
omniroute batches get <batchId>
```

### `batches create`

**Flags:**

- `--endpoint <e>`
- `--completion-window <w>`
- `--metadata <kv>`

**Example:**

```bash
omniroute batches create
```

### `batches submit`

**Flags:**

- `--endpoint <e>`
- `--wait`

**Example:**

```bash
omniroute batches submit
```

### `batches cancel <batchId>`

**Flags:**

- `--yes`

**Example:**

```bash
omniroute batches cancel <batchId>
```

### `batches wait <batchId>`

**Flags:**

- `--timeout <ms>`

**Example:**

```bash
omniroute batches wait <batchId>
```

### `batches output <batchId>`

**Flags:**

- `--out <path>`

**Example:**

```bash
omniroute batches output <batchId>
```

### `batches errors <batchId>`

**Flags:**

- `--out <path>`

**Example:**

```bash
omniroute batches errors <batchId>
```

### `files`

**Example:**

```bash
omniroute files
```

### `files list`

**Flags:**

- `--purpose <p>`
- `--limit <n>`

**Example:**

```bash
omniroute files list
```

### `files get <fileId>`

**Example:**

```bash
omniroute files get <fileId>
```

### `files upload <path>`

**Example:**

```bash
omniroute files upload <path>
```

### `files content <fileId>`

**Flags:**

- `--out <path>`

**Example:**

```bash
omniroute files content <fileId>
```

### `files delete <fileId>`

**Flags:**

- `--yes`

**Example:**

```bash
omniroute files delete <fileId>
```
