@kynver-app/runtime 0.2.96 → 0.2.100

package/README.md

@@ -81,10 +81,15 @@ runner credential [mint|status|list|revoke|rotate]
 config ensure-default-repo
 doctor runner-install | node-runtime | local-store | context-envelope | runtime-takeover
 report-bug [--json] [--message TEXT] [--skip-doctor]
+browser status | install [--deps] [--force]
 ```
 
 Run `kynver help` for the full flag-level usage.
 
+## Chat browser
+
+When website chat uses the browser on your computer, Kynver picks one automatically: a path you configured, then an installed Chrome / Chromium / Edge, then its own copy. If there is none, Kynver downloads Chrome for Testing (Google's official build, about 150 MB, once) into `~/.kynver/browsers` — no sudo. `kynver browser status` shows what will be used; `kynver browser install` downloads it now. On a minimal Linux or WSL install Chrome may also need system libraries: `kynver browser status` prints the exact `apt-get` / `dnf` command, and `kynver browser install --deps` runs it when sudo needs no password. On WSL the browser window appears on your Windows desktop through WSLg; without a display it runs headless. Turn the automatic download off with `"browserAutoProvision": false` in `~/.kynver/config.json`.
+
 ## Worker providers
 
 Set once in `kynver setup --provider claude|cursor|codex|gemini|gemini-api|openai-compatible` (stored in `~/.kynver/config.json` as `workerProvider`). `--provider chatgpt` / `gpt` are aliases for `codex`.
@@ -94,7 +99,7 @@ Set once in `kynver setup --provider claude|cursor|codex|gemini|gemini-api|opena
 | `cursor` (default) | `agent` on PATH ([Cursor Agent CLI](https://cursor.com/docs/cli/headless)) | `agent login` (OAuth) **or** `CURSOR_API_KEY` for headless runners. **Website chat uses this same CLI** when `workerProvider`/`chatProvider` is `cursor` — `agent` on PATH + `agent login` (or `CURSOR_API_KEY`). Missing/logged-out fails closed (no hosted-model fallback). |
 | `codex` (ChatGPT on your machine) | `codex` on PATH ([Codex CLI](https://developers.openai.com/codex/)) **or** `hermes` with `openai-codex` | `codex login` / `CODEX_API_KEY`, or `hermes auth status openai-codex`. **Website chat uses this same CLI** when `workerProvider`/`chatProvider` is `chatgpt` / `codex` / `gpt` — missing/logged-out fails closed (no hosted-model or Claude fallback). You do not need `OPENAI_API_KEY` for this path. Workers also spawn `codex exec`. When the standalone `codex` CLI is absent, harness workers can fall back to `hermes` openai-codex. |
 | `claude` (operator override) | `claude` on PATH | `claude login` (OAuth). Use `--provider claude` on dispatch/worker start, or set `executorRef: provider:claude` / `[worker-provider: claude]` on the board task. |
-| `gemini` | `gemini` on PATH ([Gemini CLI](https://github.com/google-gemini/gemini-cli)) | `gemini` login **or** `GEMINI_API_KEY` (allowlisted through the worker-env scrub, same as `CODEX_API_KEY`). Missing binary fails closed. |
+| `gemini` | Google Antigravity (`agy` on PATH, [install](https://antigravity.google/docs/cli/install)) | `kynver setup --provider gemini`, install Google Antigravity, then run `agy` once to sign in. A Gemini API key works only when `~/.gemini/antigravity-cli/settings.json` sets `"modelProvider": "gemini"` and `GEMINI_API_KEY` is set. Workers run `agy --prompt --output-format stream-json`. Set `KYNVER_GEMINI_BIN=gemini` only for a legacy enterprise `gemini` binary. Missing binary fails closed. |
 | `gemini-api` | Google Gemini over HTTP (no local CLI). Default `https://generativelanguage.googleapis.com/v1beta/openai` | `KYNVER_GEMINI_API_KEY` or `GEMINI_API_KEY` — read in the daemon parent and handed to the runner over stdin, never argv/child env. Override the endpoint with `KYNVER_GEMINI_BASE_URL`. |
 | `openai-compatible` (aliases `openai`, `openai-api`) | Any OpenAI-compatible `/v1` chat-completions URL | `KYNVER_WORKER_BASE_URL` (required) + optional `KYNVER_WORKER_API_KEY` over stdin. This is the generic HTTP path — not the ChatGPT product option. |