Cli Batches

---
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 AIRoute   # or: npx AIRoute
AIRoute --version
```

## Subcommands

### `batches`

**Example:**

```bash
AIRoute batches
```

### `batches list`

**Flags:**

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

**Example:**

```bash
AIRoute batches list
```

### `batches get <batchId>`

**Example:**

```bash
AIRoute batches get <batchId>
```

### `batches create`

**Flags:**

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

**Example:**

```bash
AIRoute batches create
```

### `batches submit`

**Flags:**

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

**Example:**

```bash
AIRoute batches submit
```

### `batches cancel <batchId>`

**Flags:**

- `--yes`

**Example:**

```bash
AIRoute batches cancel <batchId>
```

### `batches wait <batchId>`

**Flags:**

- `--timeout <ms>`

**Example:**

```bash
AIRoute batches wait <batchId>
```

### `batches output <batchId>`

**Flags:**

- `--out <path>`

**Example:**

```bash
AIRoute batches output <batchId>
```

### `batches errors <batchId>`

**Flags:**

- `--out <path>`

**Example:**

```bash
AIRoute batches errors <batchId>
```

### `files`

**Example:**

```bash
AIRoute files
```

### `files list`

**Flags:**

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

**Example:**

```bash
AIRoute files list
```

### `files get <fileId>`

**Example:**

```bash
AIRoute files get <fileId>
```

### `files upload <path>`

**Example:**

```bash
AIRoute files upload <path>
```

### `files content <fileId>`

**Flags:**

- `--out <path>`

**Example:**

```bash
AIRoute files content <fileId>
```

### `files delete <fileId>`

**Flags:**

- `--yes`

**Example:**

```bash
AIRoute files delete <fileId>
```