# tcp

## Usage

```bash
bdy agent tunnel tcp|TCP [options] [host:port]
```

## Arguments

| **Argument** | **Description** |
| :--- | :--- |
| `host:port` | Target address to redirect traffic to. Host is optional and by default local machine. Port is by default 80 (optional) |

## Options

| **Option** | **Description** |
| :--- | :--- |
| `--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 |
| `-f, --follow` | Follow tunnel details |
| `--format <text|json>` | Output format: json, text. JSON CLI errors: {error:{code,message,hint}}, exit 1. Default: text (choices: "text", "json") |
| `-h, --help` | display help for command |

## Examples

### Start tcp tunnel on port 22

```bash
bdy agent tunnel tcp 22
```

### Start named tcp tunnel with whitelist

```bash
bdy agent tunnel tcp 80 -n name -w 1.1.1.1/27
```


---
Original source: https://buddy.works/docs/cli/agent/tunnel/tcp