diff --git a/GETTING-STARTED.md b/GETTING-STARTED.md index f6391a4..e514ef8 100644 --- a/GETTING-STARTED.md +++ b/GETTING-STARTED.md @@ -53,7 +53,7 @@ mache serve . # ← long-running daemon on localhost:7532 — KE claude mcp add --transport http mache http://localhost:7532/mcp ``` -> ⚠️ `mache serve` (HTTP) is a **foreground daemon** — it blocks the terminal and must stay alive for the client to connect. Run it in a second terminal, background it (`mache serve . &`), or install it as a login service. If the client reports `localhost:7532/mcp` **connection refused**, the daemon isn't running — that's the #1 first-run gotcha. (A launchd LaunchAgent that keeps it alive across logins is tracked in mache-823d91.) +> ⚠️ `mache serve` (HTTP) is a **foreground daemon** — it blocks the terminal and must stay alive for the client to connect. If the client reports `localhost:7532/mcp` **connection refused**, the daemon isn't running — that's the #1 first-run gotcha. The fix is a one-time `mache init --global`, which installs a per-user supervisor (**launchd** LaunchAgent on macOS, **systemd `--user`** unit on Linux) that starts the daemon at login and keeps it alive across restarts — no terminal to babysit. For an ad-hoc run instead, background it (`mache serve . &`) in a second terminal. **stdio (subprocess per session — no standing daemon to babysit):** diff --git a/docs/smell-debt-baseline-2026-06-24.md b/docs/smell-debt-baseline-2026-06-24.md index 24dd4f4..c2c2928 100644 --- a/docs/smell-debt-baseline-2026-06-24.md +++ b/docs/smell-debt-baseline-2026-06-24.md @@ -1,3 +1,9 @@ +--- +status: current +covers-version: v0.8.0 +last-verified: 2026-06-24 +--- + # Smell-debt baseline — 2026-06-24 First measured snapshot of structural smell debt across the ART repos, the