Agent skill

OmniRoute Setup and Config CLI

by diegosouzapw in diegosouzapw/OmniRoute

Covers omniroute's setup, config, env and autostart commands: first-time setup, per-tool configuration, environment variables and autostart control.

MITAuto-check passedDevOps & Cloud

Install OmniRoute Setup and Config CLI

skills CLI
$ npx skills add diegosouzapw/OmniRoute --skill cli-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install diegosouzapw/OmniRoute cli-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/diegosouzapw/OmniRoute.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cli-setup .claude/skills/cli-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cli-setup
GitHub stars
74k
Token cost
~789 tokens
SKILL.md length
199 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

Covers omniroute's setup, config, env and autostart commands: first-time setup, per-tool configuration, environment variables and autostart control.

  • Running the first-time omniroute setup and adding a provider
  • SKILL.md covers Overview, Quick install and Subcommands
  • Calls npm
  • Writing or validating the config that points a coding CLI tool at the gateway

What it does

Autostart has enable, disable, toggle and status subcommands. The config group lists every supported CLI tool with its configuration status, shows one tool's current config, writes config for a tool with options for the model, non-interactive mode, a confirmation skip and permission to write inside containers, and validates a config format without writing anything. A dedicated opencode subcommand generates OpenCode configuration, and a lang subcommand gets or sets the display language by code.

The env group shows all environment variables, reads a single one or sets one for the current session only. The setup command takes options such as a management password and an add-provider switch, though the excerpt is cut off before the rest, and the description also mentions checking for updates. Everything starts from installing omniroute with npm or running it through npx.

When your agent uses it

  • Running the first-time omniroute setup and adding a provider
  • Writing or validating the config that points a coding CLI tool at the gateway
  • Inspecting or changing environment variables for the current session
  • Turning omniroute autostart on or off

Example prompts

  • “Run omniroute setup non-interactively and add a provider.”
  • “Validate the config omniroute would write for opencode without saving anything.”
  • “Check whether omniroute autostart is enabled and switch it off.”

Requirements

  • The omniroute package from npm, or npx to run it

What it can do on your machine

Read from SKILL.md and the folder at commit 8ad6b1c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

OmniRoute Setup and Config CLI loads about 789 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 199 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~789

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from diegosouzapw/OmniRoute at commit 8ad6b1c, republished under its MIT licence (© diegosouzapw). 199 words, ~789 tokens.

Download SKILL.mdSave it as .claude/skills/cli-setup/SKILL.md (or your agent's skills folder).
name
cli-setup
description
Run initial setup, configure global CLI settings, manage environment variables, check for updates, and configure autostart via the CLI setup and config commands.
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

Overview

Run initial setup, configure global CLI settings, manage environment variables, check for updates, and configure autostart via the CLI setup and config commands.

Quick install

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

Subcommands

autostart

Example:

bash
omniroute autostart
autostart enable

Example:

bash
omniroute autostart enable
autostart disable

Example:

bash
omniroute autostart disable
autostart toggle

Example:

bash
omniroute autostart toggle
autostart status

Example:

bash
omniroute autostart status
config

Show or update CLI tool configuration

Example:

bash
omniroute config
config list

List all CLI tools and config status

Flags:

  • --json

Example:

bash
omniroute config list
config get <tool>

Show current config for a tool

Flags:

  • --json

Example:

bash
omniroute config get <tool>
config set <tool>

Write config for a tool

Flags:

  • --model <model>
  • --non-interactive
  • --yes
  • --allow-container-write

Example:

bash
omniroute config set <tool>
config validate <tool>

Validate config format without writing

Flags:

  • --model <model>
  • --json

Example:

bash
omniroute config validate <tool>
config opencode

Generate OpenCode config (alias for

Flags:

  • --model <model>
  • --non-interactive
  • --yes
  • --allow-container-write

Example:

bash
omniroute config opencode
config lang

Example:

bash
omniroute config lang
config get

Flags:

  • --json

Example:

bash
omniroute config get
config set <code>

Flags:

  • --force

Example:

bash
omniroute config set <code>
config list

Flags:

  • --json

Example:

bash
omniroute config list
env

Show and manage environment variables

Example:

bash
omniroute env
env show

Show current environment variables

Flags:

  • --json

Example:

bash
omniroute env show
env get <key>

Get a single environment variable

Example:

bash
omniroute env get <key>
env set <key> <value>

Set an environment variable (current session only)

Example:

bash
omniroute env set <key> <value>
setup

Flags:

  • --password <value>
  • --add-provider
  • --provider <id>
  • --provider-name <name>
  • --api-key <value>
  • --default-model <model>
  • --provider-base-url <url>
  • --test-provider
  • --non-interactive
  • --list

Example:

bash
omniroute setup
update

Flags:

  • --check
  • --apply
  • --changelog
  • --dry-run
  • --no-backup
  • --yes

Example:

bash
omniroute update

© diegosouzapw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/cli-setup of diegosouzapw/OmniRoute.

Open the folder on GitHubat commit 8ad6b1c

Compare with similar skills

OmniRoute Setup and Config CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

OmniRoute Setup and Config CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OmniRoute Setup and Config CLI this skilldiegosouzapw/OmniRoute74k—~789Automated safety check: PassMIT
Deploying Scalable Agentsmicrosoft/ai-agents-for-beginners77k—~1.5kAutomated safety check: PassMIT
Deploying Scalable Agentsmicrosoft/ai-agents-for-beginners77k—~1.6kAutomated safety check: PassMIT
Routing Architecturemajiayu000/litellm-rs116—~1.9kAutomated safety check: PassMIT
Infrastructuretheopenco/llmgateway1.7k—~714Automated safety check: PassCustom licence
Weave Router Local Testingweave-os/router5.6k—~3.1kAutomated safety check: NotesApache-2.0

Similar skills

  • Deploying Scalable Agents

    microsoft/ai-agents-for-beginners

    Official

    Take a working agent prototype to a scalable, observable production deployment on Microsoft Foundry.

    77k GitHub stars~1.5k tokensUpdated 18 days ago
    DevOps & CloudAuto-check passed
  • Deploying Scalable Agents

    microsoft/ai-agents-for-beginners

    Official

    Take one working agent prototype go scalable, observable production deployment for Microsoft Foundry.

    77k GitHub stars~1.6k tokensUpdated 18 days ago
    DevOps & CloudAuto-check passed
  • Routing Architecture

    majiayu000/litellm-rs

    LiteLLM-RS Routing Architecture. An agent skill from majiayu000/litellm-rs.

    116 GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Infrastructure

    theopenco/llmgateway

    Production infrastructure and request-origin facts for LLM Gateway — GCP hosting, production hostnames and which app serves each, deploy ordering, client IP extraction, forwarded headers, and…

    1.7k GitHub stars~714 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Stands up the Weave model router in Docker Compose and drives it with claude -p against a real or mocked upstream to reproduce and verify routing and streaming behavior.

    5.6k GitHub stars~3.1k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Hugging Face Spaces Deploy

    Vincentqyw/image-matching-webui

    Releases a new imcui version on GitHub, then deploys it to a test and a production Hugging Face Space from a dedicated huggingface branch.

    1.3k GitHub stars~721 tokensUpdated yesterday
    DevOps & CloudAuto-check passed

More from diegosouzapw/OmniRoute

All 50 skills in this repo
  • OmniRoute Backup and Sync CLI

    diegosouzapw/OmniRoute

    Backup and restore OmniRoute data from the CLI. Trigger incremental snapshots, sync to cloud storage, manage backup schedules, and restore from archive files.

    74k GitHub stars~948 tokensUpdated today
    Auto-check passed
  • OmniRoute Settings API

    diegosouzapw/OmniRoute

    Read and update global application settings: system prompts, thinking budget, IP filters, payload rules, combo defaults, and require-login configuration.

    74k GitHub starsUsed in 1 repo~3.6k tokens
    Auto-check passed
  • Quality Scan

    diegosouzapw/OmniRoute

    Runs a scoped, read-only quality scan on a repository candidate and reports exact evidence, failures and frozen debt, without treating a static scan as release acceptance.

    74k GitHub stars~748 tokensUpdated today
    Auto-check passed
  • OmniRoute Database Backups

    diegosouzapw/OmniRoute

    Trigger system backups, restore from backup files, and manage the SQLite database lifecycle. Supports export, import, and incremental snapshot strategies.

    74k GitHub starsUsed in 1 repo~395 tokens
    Auto-check passed
  • OmniRoute Provider Management

    diegosouzapw/OmniRoute

    Manages AI provider connections, API keys, OAuth flows and connection tests through OmniRoute's REST API across its 327-provider catalog.

    74k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • OmniRoute LLM Cache

    diegosouzapw/OmniRoute

    Documents OmniRoute's cache endpoints for reading cache statistics and clearing entries, statistics or the reasoning cache, with notes on TTL and similarity settings.

    74k GitHub starsUsed in 1 repo~529 tokens
    Auto-check passed

Questions about OmniRoute Setup and Config CLI

What does OmniRoute Setup and Config CLI do?

Covers omniroute's setup, config, env and autostart commands: first-time setup, per-tool configuration, environment variables and autostart control. Autostart has enable, disable, toggle and status subcommands. The config group lists every supported CLI tool with its configuration status, shows one tool's current config, writes config for a tool with options for the model, non-interactive mode, a confirmation skip and permission to write inside containers, and validates a config format without writing anything.

When should I use OmniRoute Setup and Config CLI?

OmniRoute Setup and Config CLI fits situations like: running the first-time omniroute setup and adding a provider; writing or validating the config that points a coding CLI tool at the gateway; inspecting or changing environment variables for the current session; turning omniroute autostart on or off.

How do I install OmniRoute Setup and Config CLI in Claude Code?

Run `npx skills add diegosouzapw/OmniRoute --skill cli-setup -a claude-code`. Or copy the skill folder (skills/cli-setup in diegosouzapw/OmniRoute) into .claude/skills/cli-setup in your project. Claude Code loads it when a task matches its description.

How do I install OmniRoute Setup and Config CLI in Codex?

Run `npx skills add diegosouzapw/OmniRoute --skill cli-setup -a codex`. Or copy the skill folder (skills/cli-setup in diegosouzapw/OmniRoute) into .agents/skills/cli-setup in your project. Codex loads it when a task matches its description.

Can I use OmniRoute Setup and Config CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add diegosouzapw/OmniRoute --skill cli-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cli-setup, .gemini/skills/cli-setup, .github/skills/cli-setup and .opencode/skills/cli-setup in your project.

What does OmniRoute Setup and Config CLI need to run?

Going by SKILL.md and its folder, OmniRoute Setup and Config CLI needs the command-line tools its instructions call (npm). Our summary lists: The omniroute package from npm, or npx to run it.

Does OmniRoute Setup and Config CLI access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is OmniRoute Setup and Config CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does OmniRoute Setup and Config CLI use?

OmniRoute Setup and Config CLI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does OmniRoute Setup and Config CLI use?

About 789 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to OmniRoute Setup and Config CLI?

Skills that share tags, products or a category with OmniRoute Setup and Config CLI: Deploying Scalable Agents (microsoft/ai-agents-for-beginners, 77k stars), Deploying Scalable Agents (microsoft/ai-agents-for-beginners, 77k stars), Routing Architecture (majiayu000/litellm-rs, 116 stars) and Infrastructure (theopenco/llmgateway, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OmniRoute Setup and Config CLI?

diegosouzapw (a GitHub user) maintains it in diegosouzapw/OmniRoute, which has 73,701 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 6, 2026.

Source: diegosouzapw/OmniRoute on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.