Add --host flag to control server bind address

README.md

@@ -28,6 +28,7 @@ Opens a dashboard at `http://localhost:50234` showing live agent sessions, tool
 | Flag | Description |
 |------|-------------|
 | `--port <number>` | Server port (default: 50234) |
+| `--host <address>` | Bind address (default: localhost, use 0.0.0.0 for all interfaces) |
 | `--no-browser` | Don't auto-open browser |
 | `--project <path>` | Set project directory for plan tracking |
 | `--help` | Show help |

src/server/cli.ts

@@ -2,6 +2,7 @@ import { DEFAULT_PORT } from "../shared/constants";
 
 export interface CLIFlags {
   port: number;
+  host: string;
   noBrowser: boolean;
   projectPath: string | null;
   showHelp: boolean;
@@ -11,6 +12,7 @@ export function parseArgs(): CLIFlags {
   const args = process.argv.slice(2);
   const flags: CLIFlags = {
     port: DEFAULT_PORT,
+    host: "localhost",
     noBrowser: false,
     projectPath: null,
     showHelp: false,
@@ -29,6 +31,15 @@ export function parseArgs(): CLIFlags {
         flags.port = parseInt(portValue);
         i++;
       }
+    } else if (arg === "--host") {
+      const hostValue = args[i + 1];
+      if (hostValue && /^[a-zA-Z0-9.\-:]+$/.test(hostValue)) {
+        flags.host = hostValue;
+        i++;
+      } else if (hostValue) {
+        console.warn(`[ocwatch] Invalid --host value ignored: ${hostValue}`);
+        i++;
+      }
     } else if (arg === "--project") {
       const projectPath = args[i + 1];
       if (projectPath) {
@@ -49,13 +60,15 @@ Usage: ocwatch [options]
 
 Options:
   --port <number>      Server port (default: 50234)
+  --host <address>     Bind address (default: localhost, use 0.0.0.0 for all interfaces)
   --no-browser         Skip auto-opening browser
   --project <path>     Set default project filter
   --help, -h           Show this help message
 
 Examples:
   ocwatch
   ocwatch --port 50999
+  ocwatch --host 0.0.0.0
   ocwatch --no-browser
   ocwatch --project /path/to/project
 `);

src/server/index.ts

@@ -76,10 +76,18 @@ app.use("*", errorHandler);
 
 app.use(
   "/api/*",
-  cors({
-    origin: ["http://localhost:3000", "http://localhost:50234"],
-    credentials: true,
-  })
+  cors(
+    flags.host === "0.0.0.0"
+      ? { origin: "*", credentials: false }
+      : {
+          origin: [
+            `http://localhost:3000`,
+            `http://localhost:${flags.port}`,
+            `http://${flags.host}:${flags.port}`,
+          ],
+          credentials: true,
+        }
+  )
 );
 
 registerRoutes(app, { defaultProjectIdPromise });
@@ -103,10 +111,13 @@ app.notFound(async (c) => {
 export { app };
 
 const port = flags.port;
-const url = `http://localhost:${port}`;
+const hostname = flags.host;
+const displayHost = hostname === "0.0.0.0" ? "localhost" : hostname;
+const url = `http://${displayHost}:${port}`;
 
 export default {
   port,
+  hostname,
   fetch: app.fetch,
 };