← ClaudeAtlas

dev-serverlisted

Start Tandem dev environment (server + client) and verify MCP connection
bloknayrb/tandem · ★ 18 · DevOps & Infrastructure · score 67
Install: claude install-skill bloknayrb/tandem
# Start Tandem Dev Environment Start the Tandem development servers and verify everything is connected. ## Important Gotchas - The server MUST be running before Claude Code connects via MCP - `freePort()` kills any existing process on :3478/:3479 at startup — you cannot run two instances - `freePort()` does NOT cover :5173 — an orphaned Vite from a killed `dev:standalone` survives, and because `vite.config.ts` sets `strictPort: true` the new Vite **exits with an error** rather than falling back to another port. The symptom is a dev server that won't start, not a silently-wrong URL (see step 2) - E2E tests (`npm run test:e2e`) do NOT touch :3478/:3479 — since #1492 they run on the reserved harness pair in `scripts/test-ports.ts` (Vite 4573, backend 4728/4729), so a suite run and a dev server coexist. What the harness does SIGKILL is anything holding 4728/4729. ## Steps 0. Run the doctor first — it diagnoses Node version, .mcp.json, server health, and ports before anything else: ```bash npm run doctor ``` If you pulled since the last dev-server run, also refresh dependencies (they drift): ```bash npm install ``` 1. Check if servers are already running: ```bash curl -s http://127.0.0.1:3479/health 2>/dev/null && echo "Server already running" || echo "Server not running" ``` 2. If the server is NOT running but something still holds :5173, it's an orphaned Vite from a previous `dev:standalone`. Kill it first — `strictPort: true` means the new Vi