@leo000001/opencode-quota-sidebar 4.0.16 → 4.1.1

package/README.md

@@ -297,9 +297,11 @@ OpenCode main pricing config candidates are read from these locations:
 
 ## Linux CLI Notes
 
-- `opencode-quota` will auto-start a temporary `opencode serve` when no local server is already reachable
-- recent releases clean up that temporary server more aggressively on Linux/Unix so the CLI can exit normally after printing the report
-- if the CLI still hangs on Linux, upgrade to a version that includes the server-process cleanup fix
+- `opencode-quota` auto-starts a temporary `opencode serve` when no local server is reachable and `OPENCODE_BASE_URL` is not set
+- the temporary server prefers `127.0.0.1:4096`; if that port is busy, the CLI retries on another local port automatically
+- the CLI waits up to 60 seconds for the temporary server to finish booting
+- the temporary server is closed on normal completion and best-effort cleanup paths (`exit`, `SIGINT`, `SIGTERM`, `uncaughtExceptionMonitor`), and a detached watchdog kills it after 10 minutes if it is somehow left behind
+- if the CLI still hangs or temp-server startup keeps failing, run `opencode serve` manually to inspect logs or set `OPENCODE_BASE_URL`
 
 ## Persistence And Aggregation
 
@@ -443,11 +445,15 @@ This means the current bucket has `12.3k` requests, and the bar rows below show
 
 - The CLI talks to the local OpenCode API at `http://localhost:4096` by default
 - Set `OPENCODE_BASE_URL` to override (e.g. `http://192.168.1.10:4096`)
-- If no server is running and `OPENCODE_BASE_URL` is not set, the CLI attempts to start one:
-  - **Linux/macOS**: runs `opencode serve --hostname=127.0.0.1 --port=4096`
+- If no server is running and `OPENCODE_BASE_URL` is not set, the CLI attempts to start a temporary local server:
+  - **Linux/macOS**: runs `opencode serve --hostname=127.0.0.1 --port=<chosen-port>`
   - **Windows**: tries `opencode.cmd`, then `opencode` via `shell: true`, then `bash -lc opencode`
-- The auto-start waits up to 10 seconds for the server to print `opencode server listening on <url>`
+- Auto-start prefers `127.0.0.1:4096` and retries on another local port if `4096` is already in use
+- The auto-start waits up to 60 seconds for the server to print `opencode server listening on <url>`
+- The temporary server is closed on normal CLI completion and best-effort cleanup hooks (`exit`, `SIGINT`, `SIGTERM`, uncaught exception monitoring)
+- A detached watchdog also enforces a max lifetime of 10 minutes for that temporary server
 - If auto-start fails, check that `opencode` is in your `PATH`
+- If the temporary server later errors after startup, the CLI prints a short hint to run `opencode serve` manually for logs or set `OPENCODE_BASE_URL`
 - On Windows, the `shell: true` path is usually the most reliable when `opencode.cmd` is not directly spawnable from Node
 
 ### Platform notes