Document local CLI setup and harden live search suggestions

docs/API_CLI_REFERENCE.md

@@ -529,6 +529,29 @@ stella doctor suggest "gateway returns 404 on known route" --json
 
 ## stella advisoryai index rebuild
 
+### Local repo build and use of the Stella CLI
+
+When working from this repository, do not assume `stella` is already installed on `PATH`.
+Use one of these local workflows first:
+
+```bash
+# Run the CLI directly from source
+dotnet run --project "src/Cli/StellaOps.Cli/StellaOps.Cli.csproj" -- advisoryai index rebuild --json
+
+# Publish a reusable local binary
+dotnet publish "src/Cli/StellaOps.Cli/StellaOps.Cli.csproj" -c Release -o ".artifacts/stella-cli"
+
+# Windows
+.artifacts/stella-cli/StellaOps.Cli.exe advisoryai index rebuild --json
+
+# Linux/macOS
+./.artifacts/stella-cli/StellaOps.Cli advisoryai index rebuild --json
+```
+
+Related docs:
+- CLI quickstart: `docs/modules/cli/guides/quickstart.md`
+- AdvisoryAI live test setup: `src/AdvisoryAI/__Tests/INFRASTRUCTURE.md`
+
 Rebuild the AdvisoryAI deterministic knowledge index from local markdown, OpenAPI specs, and Doctor metadata.
 
 ### Synopsis