How do I install the Omniroute CLI skill?

Run npx skillmds@latest add pablolira-1982/omniroute-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Omniroute CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Omniroute CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Omniroute CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Omniroute CLI?

pablolira-1982 (@pablolira-1982) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Omniroute CLI by pablolira-1982 — Agent Skill

Name: Omniroute CLI
Author: pablolira-1982

Omniroute CLI

Entry point for the OmniRoute CLI (omniroute binary) — install, global flags, output formats, environment variables, and index of CLI capability skills. Use when the user wants to control OmniRoute from the terminal, automate workflows, or integrate with CI/CD.

File contents

OmniRoute — CLI (Entry Point)

The omniroute binary ships with the OmniRoute server. It is both the server launcher and a full management CLI with 250+ commands across 39 groups.

Install

npm install -g omniroute          # npm registry
# or: use the binary bundled with the desktop app

Requires Node.js ≥20.20.2, ≥22.22.2, or ≥24.

Verify:

omniroute --version   # prints installed version
omniroute --help      # full command tree

Connection

Every CLI command that talks to the server reads two values:

Source	Variable / Flag
Base URL	`OMNIROUTE_BASE_URL` or `--base-url`
API key	`OMNIROUTE_API_KEY` or `--api-key`

Default base URL: http://localhost:20128

export OMNIROUTE_BASE_URL="http://localhost:20128"
export OMNIROUTE_API_KEY="sk-..."          # from Dashboard → API Manager

For a remote server:

export OMNIROUTE_BASE_URL="https://your-server.com"

Global flags

Flag	Description
`--base-url <url>`	Override server URL for this invocation
`--api-key <key>`	Override API key for this invocation
`--output <format>`	Output format: `table` (default), `json`, `jsonl`, `csv`
`--json`	Shorthand for `--output json`
`--non-interactive`	Disable prompts — for CI / shell scripts
`--no-open`	Don't auto-open the browser on start
`--port <n>`	Override default port 20128
`--help`, `-h`	Show help for the current command
`--version`, `-v`	Print the installed version

Output formats

All listing commands support --output:

omniroute combo list                      # human-readable table
omniroute combo list --output json        # JSON array
omniroute combo list --output jsonl       # one JSON object per line
omniroute combo list --output csv         # CSV with header row

Quick start: one-shot server + provider setup

# 1. Start server
omniroute

# 2. (First run) interactive setup wizard
omniroute setup

# 3. Verify everything is healthy
omniroute doctor

CLI capability skills

Capability	Skill
Server admin + backup	https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omniroute-cli-admin/SKILL.md
Provider & key management	https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omniroute-cli-providers/SKILL.md
Cloud agents (Codex / Devin / Jules)	https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omniroute-cli-cloud/SKILL.md
Evals & benchmarking	https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omniroute-cli-eval/SKILL.md

API skills (REST)

For direct HTTP usage instead of the CLI, see the OmniRoute entry-point skill.

Errors

Connection refused → server not running; run omniroute or omniroute serve
401 Unauthorized → wrong or missing API key
command not found: omniroute → not in PATH; check npm root -g or re-install
doctor reports SQLite incompatible → npm rebuild better-sqlite3 in the app directory

---name: omniroute-clidescription: Entry point for the OmniRoute CLI (omniroute binary) — install, global flags, output formats, environment variables, and index of CLI capability skills. Use when the user wants to control OmniRoute from the terminal, automate workflows, or integrate with CI/CD.---# OmniRoute — CLI (Entry Point)The `omniroute` binary ships with the OmniRoute server. It is both the server launcher and a full management CLI with 250+ commands across 39 groups.## Install```bashnpm install -g omniroute # npm registry# or: use the binary bundled with the desktop app```Requires Node.js ≥20.20.2, ≥22.22.2, or ≥24.Verify:```bashomniroute --version # prints installed versionomniroute --help # full command tree```## ConnectionEvery CLI command that talks to the server reads two values:| Source | Variable / Flag || -------- | ------------------------------------ || Base URL | `OMNIROUTE_BASE_URL` or `--base-url` || API key | `OMNIROUTE_API_KEY` or `--api-key` |Default base URL: `http://localhost:20128````bashexport OMNIROUTE_BASE_URL="http://localhost:20128"export OMNIROUTE_API_KEY="sk-..." # from Dashboard → API Manager```For a remote server:```bashexport OMNIROUTE_BASE_URL="https://your-server.com"```## Global flags| Flag | Description || ------------------- | -------------------------------------------------------- || `--base-url <url>` | Override server URL for this invocation || `--api-key <key>` | Override API key for this invocation || `--output <format>` | Output format: `table` (default), `json`, `jsonl`, `csv` || `--json` | Shorthand for `--output json` || `--non-interactive` | Disable prompts — for CI / shell scripts || `--no-open` | Don't auto-open the browser on start || `--port <n>` | Override default port 20128 || `--help`, `-h` | Show help for the current command || `--version`, `-v` | Print the installed version |## Output formatsAll listing commands support `--output`:```bashomniroute combo list # human-readable tableomniroute combo list --output json # JSON arrayomniroute combo list --output jsonl # one JSON object per lineomniroute combo list --output csv # CSV with header row```## Quick start: one-shot server + provider setup```bash# 1. Start serveromniroute# 2. (First run) interactive setup wizardomniroute setup# 3. Verify everything is healthyomniroute doctor```## CLI capability skills| Capability | Skill || ------------------------------------ | ----------------------------------------------------------------------------------------------------- || Server admin + backup | https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omniroute-cli-admin/SKILL.md || Provider & key management | https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omniroute-cli-providers/SKILL.md || Cloud agents (Codex / Devin / Jules) | https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omniroute-cli-cloud/SKILL.md || Evals & benchmarking | https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omniroute-cli-eval/SKILL.md |## API skills (REST)For direct HTTP usage instead of the CLI, see the [OmniRoute entry-point skill](https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omniroute/SKILL.md).## Errors- `Connection refused` → server not running; run `omniroute` or `omniroute serve`- `401 Unauthorized` → wrong or missing API key- `command not found: omniroute` → not in PATH; check `npm root -g` or re-install- `doctor` reports SQLite incompatible → `npm rebuild better-sqlite3` in the app directory

Frequently asked questions