| name | start-dev-website |
| description | Start the Mycosoft website dev server on port 3010. Use when the user wants to run the dev server, start development, or test the website locally. |
Start Website Dev Server
CRITICAL: Execute Yourself
NEVER ask the user to run these commands. You MUST execute them yourself via run_terminal_cmd. See agent-must-execute-operations.mdc.
Quick Start
The dev server MUST run on port 3010. Use dev:next-only to avoid starting GPU services.
Step 1: Free port 3010 if needed (Windows PowerShell)
$conn = Get-NetTCPConnection -LocalPort 3010 -ErrorAction SilentlyContinue
if ($conn) {
Stop-Process -Id $conn.OwningProcess -Force
Write-Host "Freed port 3010"
}
Step 2: Start dev server
npm run dev:next-only
This runs next dev --port 3010 without starting GPU services (PersonaPlex, Moshi, Earth2).
Step 3: Verify
Open http://localhost:3010 in browser.
Environment Variables
The website connects to backend VMs. Ensure .env.local has:
MAS_API_URL=http://192.168.0.188:8001
NEXT_PUBLIC_MAS_API_URL=http://192.168.0.188:8001
MINDEX_API_URL=http://192.168.0.189:8000
MINDEX_API_BASE_URL=http://192.168.0.189:8000
When to use npm run dev (full stack)
Only use npm run dev when you need GPU services (voice, Earth2). It spawns a separate "GPU Services" window with Python processes that persist after terminal close.
If GPU services were started and are no longer needed, run:
cd scripts
.\dev-machine-cleanup.ps1 -KillStaleGPU
Key Details
| Item | Value |
|---|
| Dev URL | http://localhost:3010 |
| Command | npm run dev:next-only |
| Port | 3010 (NEVER use another port) |
| GPU-free | Yes (no PersonaPlex/Earth2) |
