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

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

Manages ngrok, Cloudflare, and custom tunnel connections through the OmniRoute CLI. Handy when you need to expose local servers and inspect active URLs.

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

What cli-tunnel does

The skill equips your coding agent to start and stop network tunnels straight from the chat. It interfaces directly with the omniroute tunnel command suite. You can launch ngrok or Cloudflare tunnels, fetch active public URLs, and test whether your service is reachable externally.

Under the hood, it triggers subcommands such as omniroute tunnel create [type], omniroute tunnel list, and omniroute tunnel info <type>. It also handles rotation with --yes and pulls recent output using --tail <n>. Several subcommands accept --json for structured output parsing.

The skill relies entirely on the omniroute package. You must install it globally via npm install -g omniroute or have npx configured, or every tunnel action will fail.

What it helps with

  • start a public tunnel using ngrok or Cloudflare
  • inspect active tunnel URLs and external reachability
  • view recent tunnel logs with custom tail limits
  • rotate tunnel endpoints via command-line flags

Example prompts for the agent

  • List all running tunnels in omniroute with json output
  • Create a new Cloudflare tunnel for my local port
  • Check the status and logs of the active ngrok tunnel

How to install cli-tunnel

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

careful garrytan Intercepts Bash and PowerShell commands before execution to catch destructive actions like forced git pushes or database drops. Useful when giving agents terminal access. Claude Code CX Codex Cursor +1 375installs bullmq-specialist sickn33 Guides an agent through BullMQ queues backed by Redis, worker handling, and failure cases. Use it for background jobs, schedules, and dependent work. Claude Code CX Codex Cursor +1 2,100installs wizard Matt Pocock This skill creates an interactive bash wizard for manual setup steps, CI secrets, third-party dashboards, and one-off migrations. Claude Code 553,369installs hyperframes-cli heygen-com Controls HyperFrames video workflows from the CLI: audits layouts and contrast, edits timeline clips, captures snapshots, and renders locally or in cloud runtimes. Claude Code CX Codex Cursor +1 1,200,000installs setup-pre-commit Matt Pocock This skill configures pre-commit checks for a JavaScript repository, running Prettier, type checking, and tests before each commit. Claude Code 489,289installs using-git-worktrees Jesse Vincent Prepares an isolated workspace before feature work or plan execution. It checks the repository first, then uses native worktree support or Git. Claude Code CX Codex 217,153installs finishing-a-development-branch Jesse Vincent This skill checks the test suite and guides branch completion: merge locally, open a Pull Request, or leave the work in place. Claude Code CX Codex 214,439installs orca-cli stablyai The skill lets an agent manage Orca worktrees, terminals, artifacts and the built-in browser through the orca CLI. Useful when your work already runs inside Orca. Claude Code CX Codex Cursor +1 353,000installs

Questions about cli-tunnel

How to install cli-tunnel in Claude Code?

Run npx skills add cheaper-inference/OmniRoute --skill cli-tunnel -a claude-code in your terminal.

What does cli-tunnel do?

It provides CLI controls to launch, inspect, and stop tunnels like ngrok or Cloudflare via OmniRoute.

What prerequisites are needed for cli-tunnel?

You need the omniroute CLI installed via npm install -g omniroute or executable via npx.

Source text

SKILL.md · MIT
---
name: cli-tunnel
description: Start and stop tunnel connections (ngrok, Cloudflare, custom) from the CLI. Inspect active tunnel URLs, configure authentication, and test external reachability.
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

Start and stop tunnel connections (ngrok, Cloudflare, custom) from the CLI. Inspect active tunnel URLs, configure authentication, and test external reachability.

## Quick install

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

## Subcommands

### `tunnel`

**Example:**

```bash
omniroute tunnel
```

### `tunnel list`

**Flags:**

- `--json`

**Example:**

```bash
omniroute tunnel list
```

### `tunnel create [type]`

**Example:**

```bash
omniroute tunnel create [type]
```

### `tunnel stop <type>`

**Flags:**

- `--yes`

**Example:**

```bash
omniroute tunnel stop <type>
```

### `tunnel status <type>`

**Flags:**

- `--json`

**Example:**

```bash
omniroute tunnel status <type>
```

### `tunnel logs <type>`

**Flags:**

- `--tail <n>`

**Example:**

```bash
omniroute tunnel logs <type>
```

### `tunnel info <type>`

**Flags:**

- `--json`

**Example:**

```bash
omniroute tunnel info <type>
```

### `tunnel rotate <type>`

**Flags:**

- `--yes`

**Example:**

```bash
omniroute tunnel rotate <type>
```

© 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