feat: add configurable port and switch to IPv4 by default

- Add PTY_WEB_PORT env var for fixed port (0 = random)
- Change default hostname from ::1 (IPv6) to 127.0.0.1 (IPv4)
- Update README with new environment variable

Author: mrwuliu

README.md

@@ -224,7 +224,8 @@ This eliminates the need for polling—perfect for long-running processes like b
 | Variable               | Default    | Description                                        |
 | ---------------------- | ---------- | -------------------------------------------------- |
 | `PTY_MAX_BUFFER_LINES` | `50000`    | Maximum lines to keep in output buffer per session |
-| `PTY_WEB_HOSTNAME`     | `::1`      | Hostname for the web server to bind to             |
+| `PTY_WEB_HOSTNAME`     | `127.0.0.1`| Hostname for the web server to bind to (IPv4)      |
+| `PTY_WEB_PORT`         | `0` (random) | Port for the web server (0 = random port)        |
 
 ### Permissions
 

src/web/server/server.ts

@@ -41,8 +41,8 @@ export class PTYServer implements Disposable {
 
   private startWebServer(): Server<undefined> {
     return Bun.serve({
-      port: 0,
-      hostname: process.env.PTY_WEB_HOSTNAME ?? '::1',
+      port: process.env.PTY_WEB_PORT ? parseInt(process.env.PTY_WEB_PORT, 10) : 0,
+      hostname: process.env.PTY_WEB_HOSTNAME ?? '127.0.0.1',
 
       routes: {
         ...this.staticRoutes,