Agent skill

OmniRoute Key and OAuth CLI

by diegosouzapw in diegosouzapw/OmniRoute

Command reference for managing OmniRoute API keys and provider OAuth connections from the terminal: create, list, rotate, revoke and inspect limits.

MITAuto-check passedBackend & APIs

Install OmniRoute Key and OAuth CLI

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

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

GitHub CLI
$ gh skill install diegosouzapw/OmniRoute cli-keys --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-keys .claude/skills/cli-keys && 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-keys
GitHub stars
74k
Token cost
~621 tokens
SKILL.md length
138 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

Command reference for managing OmniRoute API keys and provider OAuth connections from the terminal: create, list, rotate, revoke and inspect limits.

  • Rotating an OmniRoute API key with a grace period
  • SKILL.md covers Overview, Quick install and Subcommands
  • Calls npm
  • Limiting a key's rate, spend or allowed models

What it does

The skill lists the `omniroute` subcommands for keys and OAuth, installed with `npm install -g omniroute` or run through npx. Under `keys` you add a provider key (optionally from stdin), list keys with JSON output, remove, regenerate, revoke, reveal, show and view usage with a limit. `keys set` applies a rate limit, a maximum cost and an allowed-models list, `keys expiration` reports upcoming expiry in a number of days, and `keys rotate` accepts a grace period.

Under `oauth` the commands list providers, start a flow for a chosen provider with options to skip the browser, import credentials from the system, pick a social login or set a timeout, check status, and revoke a provider or a single connection. Destructive subcommands take a `--yes` flag to skip confirmation. The text is a flag-by-flag listing with little explanation of behavior.

When your agent uses it

  • Rotating an OmniRoute API key with a grace period
  • Limiting a key's rate, spend or allowed models
  • Checking which provider OAuth connections exist and revoking one

Example prompts

  • “List my OmniRoute keys as JSON and show which ones expire soon.”
  • “Rotate the production key and keep the old one valid for a short grace period.”
  • “Revoke the OAuth connection for one provider without touching the others.”

Requirements

  • Node.js with npm to install `omniroute`
  • An OmniRoute instance with provider credentials

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 Key and OAuth CLI loads about 621 tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 138 words of instructions outside code blocks.

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

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). 138 words, ~621 tokens.

Download SKILL.mdSave it as .claude/skills/cli-keys/SKILL.md (or your agent's skills folder).
name
cli-keys
description
Create, list, rotate, and revoke OmniRoute API keys from the CLI. Manage OAuth flows for provider authentication and inspect key scopes and expiration.
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

Overview

Create, list, rotate, and revoke OmniRoute API keys from the CLI. Manage OAuth flows for provider authentication and inspect key scopes and expiration.

Quick install

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

Subcommands

keys

Example:

bash
omniroute keys
keys add <provider> [apiKey]

Flags:

  • --stdin

Example:

bash
omniroute keys add <provider> [apiKey]
keys list

Flags:

  • --json

Example:

bash
omniroute keys list
keys remove <provider>

Flags:

  • --yes

Example:

bash
omniroute keys remove <provider>
keys regenerate <id>

Flags:

  • --yes

Example:

bash
omniroute keys regenerate <id>
keys revoke <id>

Flags:

  • --yes

Example:

bash
omniroute keys revoke <id>
keys reveal <id>

Example:

bash
omniroute keys reveal <id>
keys usage <id>

Flags:

  • --limit <n>

Example:

bash
omniroute keys usage <id>
keys policy

Example:

bash
omniroute keys policy
keys show <id>

Example:

bash
omniroute keys show <id>
keys set <id>

Flags:

  • --rate-limit <n>
  • --max-cost <n>
  • --allowed-models <list>

Example:

bash
omniroute keys set <id>
keys expiration

Example:

bash
omniroute keys expiration
keys list

Flags:

  • --days <n>
  • --json

Example:

bash
omniroute keys list
keys rotate <id>

Flags:

  • --grace-period <ms>
  • --yes

Example:

bash
omniroute keys rotate <id>
oauth

Example:

bash
omniroute oauth
oauth providers

Example:

bash
omniroute oauth providers
oauth start

Flags:

  • --provider <id>
  • --no-browser
  • --import-from-system
  • --social <s>
  • --timeout <ms>

Example:

bash
omniroute oauth start
oauth status

Flags:

  • --provider <id>

Example:

bash
omniroute oauth status
oauth revoke

Flags:

  • --provider <id>
  • --connection-id <id>
  • --yes

Example:

bash
omniroute oauth revoke

© 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-keys of diegosouzapw/OmniRoute.

Open the folder on GitHubat commit 8ad6b1c

Compare with similar skills

OmniRoute Key and OAuth 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 Key and OAuth CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OmniRoute Key and OAuth CLI this skilldiegosouzapw/OmniRoute74k—~621Automated safety check: PassMIT
Fortify Developmentcoollabsio/coolify63k4 repos~1.9kAutomated safety check: PassMIT
Better Auth Best Practiceslatitude-dev/latitude-llm4.7k7 repos~1.6kAutomated safety check: PassMIT
Security Reviewdoorkeeper-gem/doorkeeper5.5k—~1.4kAutomated safety check: PassMIT
Cognitoitsmostafa/aws-agent-skills1.2k1 repos~2.3kAutomated safety check: PassMIT
OAuth Account Setupspinabot/brigade11k—~878Automated safety check: PassMIT

Similar skills

  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed
  • Better Auth Best Practices

    latitude-dev/latitude-llm

    Configure Better Auth server and client, set up database adapters, manage sessions, add plugins, and handle environment variables.

    4.7k GitHub starsUsed in 7 repos~1.6k tokens
    Backend & APIsAuto-check passed
  • Security Review

    doorkeeper-gem/doorkeeper

    Verify that code changes do not introduce OAuth security vulnerabilities.

    5.5k GitHub stars~1.4k tokensUpdated today
    Backend & APIsAuto-check passed
  • Cognito

    itsmostafa/aws-agent-skills

    AWS Cognito user authentication and authorization service. An agent skill from itsmostafa/aws-agent-skills.

    1.2k GitHub starsUsed in 1 repo~2.3k tokens
    Backend & APIsAuto-check passed
  • OAuth Account Setup

    spinabot/brigade

    Connects an OAuth 2.0 account such as Gmail with the built-in oauth_authorize tool: an authorization link, automatic code capture and sealed token storage.

    11k GitHub stars~878 tokensUpdated 4 days ago
    Backend & APIsAuto-check passed
  • Auth Implementation Patterns

    ynulihao/AgentSkillOS

    Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems.

    617 GitHub starsUsed in 9 repos~4.4k tokens
    Backend & APIsAuto-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

Categories

Questions about OmniRoute Key and OAuth CLI

What does OmniRoute Key and OAuth CLI do?

Command reference for managing OmniRoute API keys and provider OAuth connections from the terminal: create, list, rotate, revoke and inspect limits. The skill lists the `omniroute` subcommands for keys and OAuth, installed with `npm install -g omniroute` or run through npx. Under `keys` you add a provider key (optionally from stdin), list keys with JSON output, remove, regenerate, revoke, reveal, show and view usage with a limit.

When should I use OmniRoute Key and OAuth CLI?

OmniRoute Key and OAuth CLI fits situations like: rotating an OmniRoute API key with a grace period; limiting a key's rate, spend or allowed models; checking which provider OAuth connections exist and revoking one.

How do I install OmniRoute Key and OAuth CLI in Claude Code?

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

How do I install OmniRoute Key and OAuth CLI in Codex?

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

Can I use OmniRoute Key and OAuth 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-keys -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-keys, .gemini/skills/cli-keys, .github/skills/cli-keys and .opencode/skills/cli-keys in your project.

What does OmniRoute Key and OAuth CLI need to run?

Going by SKILL.md and its folder, OmniRoute Key and OAuth CLI needs the command-line tools its instructions call (npm). Our summary lists: Node.js with npm to install `omniroute`; An OmniRoute instance with provider credentials.

Does OmniRoute Key and OAuth 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 Key and OAuth 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 Key and OAuth CLI use?

OmniRoute Key and OAuth 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 Key and OAuth CLI use?

About 621 tokens (SKILL.md is roughly 2.5k 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 Key and OAuth CLI?

Skills that share tags, products or a category with OmniRoute Key and OAuth CLI: Fortify Development (coollabsio/coolify, 63k stars), Better Auth Best Practices (latitude-dev/latitude-llm, 4.7k stars), Security Review (doorkeeper-gem/doorkeeper, 5.5k stars) and Cognito (itsmostafa/aws-agent-skills, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OmniRoute Key and OAuth 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.