Create instance ports from the CLI

.agents/skills/brev-cli/SKILL.md

@@ -174,6 +174,12 @@ brev port-forward my-instance -p 8080:8080
 # List Brev-managed HTTP and network ports for an instance or external node
 brev ports ls my-instance
 brev ports ls my-node --json
+
+# Create a public port (TCP by default)
+brev ports create my-instance 8080
+brev ports create my-node 53 --protocol udp --allow 203.0.113.10/32
+brev ports create my-instance 3000 --protocol http --public
+brev ports create my-instance 8888 --protocol http --authorize me@example.com
 ```
 
 ### Listing Instances and Nodes

.agents/skills/brev-cli/reference/commands.md

@@ -511,6 +511,41 @@ brev ports ls my-node
 brev ports ls my-instance --json
 ```
 
+#### Create a port
+
+Create a raw TCP, UDP, or SSH port, or an HTTP application endpoint, on a
+managed instance or registered compute node. `open` and `add` are aliases for
+`create`.
+
+```bash
+brev ports create <instance-or-node> <port> [flags]
+```
+
+**Flags:**
+| Flag | Description |
+|------|-------------|
+| `--protocol` | Port protocol: `tcp` (default), `udp`, `ssh`, `http`, or `https` |
+| `--allow` | Source CIDR for TCP, UDP, or SSH; repeat to add more than one |
+| `--authorize` | Email authorized for an HTTP endpoint; repeat to add more than one |
+| `--hostname` | HTTP endpoint hostname prefix; defaults to the destination port |
+| `--public` | Disable authentication for an HTTP endpoint |
+| `--json` | Output the created port as JSON |
+
+Omit `--allow` to allow raw-port connections from any source. HTTP endpoints
+default to authorizing the current user's email; use `--public` to make one
+available without authentication. `--protocol http` connects the public HTTPS
+endpoint to a plain-HTTP service, while `https` expects TLS on the destination.
+
+**Examples:**
+```bash
+brev ports create my-instance 8080
+brev ports create my-node 53 --protocol udp
+brev ports create my-instance 8080 --allow 203.0.113.10/32
+brev ports create my-node 2222 --protocol ssh --json
+brev ports create my-instance 3000 --protocol http --public
+brev ports create my-instance 8888 --protocol http --authorize me@example.com
+```
+
 ## Organization Commands
 
 ### brev org ls