@vtxmacro/cli 2026.8.18 → 2026.8.20

package/README.md

@@ -13,6 +13,8 @@ The host supports Windows x64 and Linux x64, including WSL. The package installs
 the exact supported OpenAI Codex runtime for those platforms.
 The VTX host verifies that native runtime's version and digest before use; it
 does not borrow a Codex binary from PATH or an editor extension.
+For Windows-login auto-start, install and configure the CLI from native Windows;
+a CLI installed only inside WSL cannot start the WSL virtual machine at login.
 
 ## Configure
 
@@ -60,17 +62,21 @@ bounded cooldown.
 vtx inference-host login
 vtx inference-host codex-login
 vtx inference-host doctor --json
-vtx inference-host run
-vtx inference-host status --json
+vtx inference-host service install
+vtx inference-host service status --json
+vtx inference-host service logs
 vtx inference-host logout
 vtx inference-host codex-logout
 vtx inference-host revoke
 ```
 
-This foreground host uses a separate least-privilege `insights:inference`
+This durable host uses a separate least-privilege `insights:inference`
 OAuth grant. It also keeps its ChatGPT subscription login in a dedicated private
 Codex home. Neither credential is copied from or widens the ordinary CLI or Codex
-session. VTX logout/revoke and Codex logout are intentionally separate operations.
+session. The per-user OS service starts immediately, starts again at login, and
+reconnects after sleep, network loss, or a worker exit. Stopping a VTX bot leaves
+the provider online and idle. Use `vtx inference-host run` only for foreground
+diagnostics. VTX logout/revoke and Codex logout are intentionally separate operations.
 
 Use `vtx inference-host --help` for command discovery. The VTX login verifies
 that the selected credential store can read back the exact saved grant. If an
@@ -124,6 +130,12 @@ Use `not_dispatched` only when no harness inference began,
 `outcome_unknown` when dispatch itself cannot be confirmed. Pipe exactly one
 object to `vtx inference-host agent-fail --json`.
 
+Claude Code, GitHub Copilot, Cursor, and Google Antigravity remain on the
+explicit foreground agent loop. Their supported CLI or account contracts do not
+provide the durable, private third-party service boundary VTX requires, so
+`service install --adapter ...` rejects them instead of advertising false
+durability.
+
 Keep `agent-run` open in a separate terminal and keep calling `agent-next`
 while the host should remain available. The independent keeper preserves
 truthful liveness while the harness reasons. This same loop
@@ -140,12 +152,14 @@ running bot.
 
 ## Remove
 
-First stop the foreground run or agent-run process, revoke the VTX inference
-grant, then uninstall the package. Cleanup refuses while a foreground host
-process still owns the host. Automated Codex users should also remove the
+First uninstall any durable service, stop any foreground run or agent-run process,
+revoke the VTX inference grant, then uninstall the package. Cleanup refuses while
+a foreground host process still owns the host. Automated Codex users should also remove the
 dedicated Codex login:
 
 ```bash
+vtx inference-host service stop
+vtx inference-host service uninstall
 vtx inference-host revoke
 # Automated Codex host only:
 vtx inference-host codex-logout