Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

Fail Vite when FRONTEND_PORT is already bound.

debajyoti-truefoundry5a96f5b12e75
diff --git a/packages/frontend/README.md b/packages/frontend/README.md
index cc8b4bb73..2d2f9e008 100644
--- a/packages/frontend/README.md
+++ b/packages/frontend/README.md
@@ -31,7 +31,8 @@ pnpm dev # Postgres + Redis, Vite :3000 + API :8790
Open `http://localhost:3000`: Vite serves the UI from source (edits hot-reload, no rebuild or server
restart) and proxies `/api/*` to `VITE_SERVER_URL`, default `http://localhost:8790`. `FRONTEND_PORT`
-moves Vite off `:3000`. That proxy is the only dev-specific wiring and lives entirely in
+moves Vite off `:3000`. Vite uses `strictPort` — if that port is already bound, dev exits instead of
+picking another. That proxy is the only dev-specific wiring and lives entirely in
[`vite.config.ts`](vite.config.ts); the server needs no build to answer the API.
### Server adapter
diff --git a/packages/frontend/vite.config.ts b/packages/frontend/vite.config.ts
index f8e201762..425f28e0f 100644
--- a/packages/frontend/vite.config.ts
+++ b/packages/frontend/vite.config.ts
@@ -54,6 +54,8 @@ export default defineConfig({
},
server: {
port: PORT,
+ // Fail if FRONTEND_PORT is taken — never silently hop to 3001/3010/etc.
+ strictPort: true,
// The Harness SDK already targets the server's /api routes.
proxy: {
'/api': apiProxy,