bdy tunnel tcp

$bdy tunnel tcp|TCP [options] [host:port]

Start a tunnel that forwards TCP traffic from a public port to a local address, for non-HTTP services such as SSH, RDP, SIP or game servers

ARGUMENTS

host:port

Target address to redirect traffic to. Host is optional and by default local machine. Port is by default 80 (optional)

OPTIONS

--context <name>

Connection and scope context: default, git, link or a saved name. Overrides the globally active context for this invocation.

--examples

Show only examples; with this flag --format accepts text, json or jsonl

--verbose

Show REST API requests, responses, timing and retries on stderr

-r, --region <region>

override default region ("eu", "us", "as")

-w, --whitelist <cidrs...>

Whitelist provided IP CIDRs. Use "*" to allow all

-n, --name <name>

Name of the tunnel

-t, --timeout <seconds>

Enforce connection timeout in seconds

--note <note>

Resource note

--agent-note <note>

Note for AI agents operating on this resource; stored as agent_note and meant to be read before acting on the resource

--token <token>

Token to authorize agent

--format <text|jsonl>

Output format: jsonl, text. JSONL CLI errors: {type:"error",error:{code,message,hint}}, exit 1. Default: text (choices: "text", "jsonl")

-h, --help

display help for command

Documentation for bdy v1.25.20

Last modified on Oct 14, 2026

Examples

Start tcp tunnel on port 22
bdy tunnel tcp 22$

Start named tcp tunnel with whitelist
bdy tunnel tcp 80 -n name -w 1.1.1.1/27$