From f06954a2900fde86760ba289e3aa99d80d860212 Mon Sep 17 00:00:00 2001 From: "bojana.dejanovic" Date: Mon, 23 Mar 2026 14:27:04 +0100 Subject: [PATCH] updated readme to add details about windows bun install and wsl specifics --- README.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/README.md b/README.md index 68e2e4f..c51b55e 100644 --- a/README.md +++ b/README.md @@ -37,6 +37,29 @@ gloop/ --- +## Windows quirks + +**Installing Bun on Windows:** + +```powershell +powershell -c "irm bun.sh/install.ps1|iex" +``` + +**Using WSL with LM Studio:** + +If you're running the agent inside WSL (Windows Subsystem for Linux), `localhost` inside WSL resolves to WSL's own loopback — not your Windows host. LM Studio running on Windows won't be reachable at `http://localhost:1234` from WSL. + +Fix: enable **Serve on Local Network** in LM Studio's Server Settings (as shown in the screenshot above). LM Studio will then display your Windows machine's local network address (e.g. `http://172.21.80.1:1234`). Copy that address and replace `http://localhost:1234` in [client.ts](client.ts): + +```typescript +const openai = new OpenAI({ + baseURL: "http://172.21.80.1:1234/v1", // your Windows IP from LM Studio + apiKey: "lm-studio", +}) +``` + +--- + ## How Coding Agents Work — Reference Guide A companion to the codebase. Read this, then read the code. You'll understand exactly how coding agents like Claude Code and Cursor work under the hood.