Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

cli-batches — Claude Code skill: what it does, how to install

Submit and monitor batch inference jobs from the CLI using OmniRoute. Upload input files, inspect batch status, and retrieve results for CI/CD pipelines.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add cheaper-inference/OmniRoute --skill cli-batches -a claude-code
Open on GitHub

What cli-batches does

This skill provides commands to run batch inference through the omniroute CLI. With omniroute batches submit, you pass a JSONL file, choose an endpoint, and optionally hold execution using --wait. Tasks can also be staged separately by uploading files and passing IDs to batches create.

File handling relies on the omniroute files subcommand. It covers file uploads, content retrieval, and deletions with confirmation flags. If execution fails, errors can be exported to a separate file using omniroute batches errors.

Working with this skill requires the omniroute binary installed globally via npm or executed with npx. Without the underlying CLI tool available in your path, every command will fail.

What it helps with

  • submit JSONL files for batch model inference
  • monitor batch job execution and retrieve output files
  • upload and manage remote files for processing
  • inspect error logs from failed batch runs

Example prompts for the agent

  • Submit data.jsonl for batch processing with omniroute batches submit
  • Check the progress of batch <batchId> using omniroute batches wait
  • Save batch errors for <batchId> to an output file via omniroute batches errors

How to install cli-batches

1Skills CLI (Vercel)

npx skills add cheaper-inference/OmniRoute --skill cli-batches -a claude-code

2Manually: put the files in place

~/.claude/skills/cli-batches/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cli-batches/

From the same set34

The whole set →
cli-setup cheaper-inference Helps the agent configure OmniRoute, manage autostart, apply CLI updates, and adjust session environment variables. Claude Code CX Codex Cursor +1 1,200installs omni-combos-routing cheaper-inference This skill creates and manages model routing combos with fallback chains, tests, and metrics. Use it when OmniRoute needs configurable provider routing. Claude Code CX Codex Cursor +1 1,200installs omni-inference cheaper-inference Connects OpenAI-compatible inference endpoints for chat, embeddings, audio, and images. Useful for AI agents calling OmniRoute endpoints. Claude Code CX Codex Cursor +1 1,100installs cli-providers cheaper-inference Manage OmniRoute provider connections from the CLI: inspect the catalog, test connections, rotate keys, and view metrics. Useful when provider setup is part of your terminal workflow. Claude Code CX Codex Cursor +1 1,100installs omni-auth cheaper-inference Manage API keys and sessions in OmniRoute. Authenticates requests via Bearer tokens, handles dashboard login with password or OIDC, and controls session access. Claude Code CX Codex Cursor +1 1,100installs cli-routing cheaper-inference Manage model routing combos from the command line with omniroute. Test routing strategies, inspect metrics, and configure fallback chains interactively. Claude Code CX Codex Cursor +1 1,100installs omni-mcp cheaper-inference Connects an agent to the OmniRoute MCP server for request routing, memory, cache, and audit work. Use it when those operations need to be available as MCP tools. Claude Code CX Codex Cursor +1 1,100installs omni-providers cheaper-inference Manages connections to 375 AI providers via REST API: adds keys, tests connections, syncs models. Claude Code CX Codex Cursor +1 1,100installs

Similar

market-segments phuryn Skill to identify and analyze 3–5 customer segments: demographics, jobs-to-be-done, pain points, and product fit. Use it to understand who to target and why. Claude Code CX Codex Cursor +1 2,800installs news-aggregator-skill cclank The skill pulls fresh posts from Hacker News, GitHub, arXiv, Hugging Face Papers, BBC, Reuters and about forty other sources, plus user OPML feeds, and turns them into one report. Claude Code CX Codex Cursor +1 6,000installs songsee community Generates spectrograms and multi-panel audio feature visualizations (mel, chroma, MFCC) via CLI. Useful for analyzing sound, comparing audio outputs, or documenting processing pipelines. Claude Code CX Codex Cursor +1 369installs scientific-schematics K-Dense-AI Creates PNG drafts of scientific diagrams and runs a separate quality review. Use it for neural network architectures, flowcharts, system diagrams, and biological pathways. Claude Code CX Codex Cursor +1 2,200installs scikit-learn K-Dense-AI A skill for Python machine learning tasks: classification, regression, clustering, preprocessing, and building ML pipelines with scikit-learn 1.9.1. Claude Code CX Codex Cursor +1 2,200installs skill-creator official anthropics Creates and refines skills, then tests them with prompts, evaluations, and performance checks. Claude Code Claude.ai 414,180installs writing-for-agents Matt Pocock Guidance for writing skills and agent-facing documents. Use it when editing AGENTS.md, CLAUDE.md, or reference files reached from them. Claude Code 466,719installs media-use heygen-com Finds or generates media for HyperFrames videos, including voiceovers, music, cutouts, and color grades. Stores files locally in assets. Claude Code CX Codex Cursor +1 1,100,000installs

Questions about cli-batches

How to install cli-batches in Claude Code?

Run npx skills add cheaper-inference/OmniRoute --skill cli-batches -a claude-code in your terminal. You must also install the CLI tool via npm install -g omniroute.

What does the cli-batches skill do?

It lets you submit batch inference workloads, monitor their status, and manage processing files directly from the command line.

What prerequisites are needed for cli-batches?

You need Node.js with omniroute installed globally via npm or run through npx. Check the tool with omniroute --version.

Source text

SKILL.md · MIT
---
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:**

- `--input-file <fileId>`
- `--endpoint <e>`
- `--completion-window <w>`
- `--metadata <kv>`

**Example:**

```bash
omniroute batches create
```

### `batches submit`

**Flags:**

- `--jsonl <path>`
- `--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>`

**Flags:**

- `--purpose <p>`

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

© cheaper-inference · MIT · cheaper-inference/OmniRoute

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor