tunnelto

tunnelto lets you expose your locally running web server via a public URL. Written in Rust. Built completely with async-io on top of tokio.

1. Install
2. Usage Instructions
3. For agents

Install

Brew (macOS)

brew install tunneltodev/tap/tunnelto

Cargo

cargo install tunnelto

Everywhere

Or Download a release for your target OS here: tunnelto/releases

Usage

Quick Start

tunnelto --port 8000

The above command opens a tunnel and forwards traffic to localhost:8000.

More Options:

tunnelto 0.1.20

USAGE:
    tunnelto [FLAGS] [OPTIONS] [SUBCOMMAND]

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information
    -v, --verbose    A level of verbosity, and can be used multiple times

OPTIONS:
        --dashboard-address     Sets the address of the local introspection dashboard
    -k, --key                                 Sets an API authentication key to use for this tunnel
        --host 
            Sets the HOST (i.e. localhost) to forward incoming tunnel traffic to [default: localhost]

    -p, --port 
            Sets the port to forward incoming tunnel traffic to on the target host

        --scheme 
            Sets the SCHEME (i.e. http or https) to forward incoming tunnel traffic to [default: http]

    -s, --subdomain                    Specify a sub-domain for this tunnel

SUBCOMMANDS:
    help        Prints this message or the help of the given subcommand(s)
    set-auth    Store the API Authentication key

For agents

This repo ships an agent skill at skills/tunnelto/SKILL.md that teaches coding agents (Claude Code, Codex, Cursor, …) how to install the CLI, authenticate, open a tunnel from a script, and read the public URL back.

npx skills add tunneltodev/tunnelto

A plain-text guide is also served at https://tunnelto.dev/AGENTS.md.