@vtxmacro/cli 2026.8.30 → 2026.8.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +26 -0
  2. package/bin/vtx.js +758 -210
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -58,6 +58,10 @@ exposed. Before starting a Trader, confirm that the VTX AI page shows the
58
58
  intended authenticated ChatGPT email and plan. The host reads the live Codex
59
59
  account window: a reached limit pauses new dispatch until its reported reset,
60
60
  while a transient throttle uses a short bounded cooldown.
61
+ The selected AI model row shows the open VTX profile's rolling 1-hour, 24-hour,
62
+ and 7-day request and reported-token activity for that subscription path.
63
+ Account-wide quota percentages remain in safe host diagnostics instead of the
64
+ profile-scoped selector.
61
65
 
62
66
  ```bash
63
67
  vtx inference-host login
@@ -71,6 +75,25 @@ vtx inference-host codex-logout
71
75
  vtx inference-host revoke
72
76
  ```
73
77
 
78
+ To connect another Codex subscription to the same VTX account, repeat the
79
+ login and service-install commands with a stable local name such as
80
+ `--instance codex-2`. Each named instance has an isolated VTX grant, Codex
81
+ home, credential file, runtime state, recovery state, and worker; one per-user
82
+ OS supervisor runs all installed instances. Use `service status --json` to
83
+ inspect the installed workers. The installer rejects duplicate authenticated
84
+ ChatGPT emails and fails closed when it cannot prove multiple subscriptions are
85
+ distinct. Use `service uninstall --instance <name>` to remove one worker;
86
+ unqualified `service uninstall` removes the whole supervisor. The legacy
87
+ unqualified host commands continue to target `default`.
88
+
89
+ Automated hosts do not impose a subscription-specific profile-count or
90
+ concurrency limit by default. Set an explicit positive integer with
91
+ `--max-concurrency` when you want a local limit. Every active turn shares the live subscription
92
+ rate-limit gate and cooldown; unlimited local admission does not guarantee
93
+ capacity beyond the authenticated account's current entitlement. Updating from
94
+ an older bounded host removes its previous numeric limit; run
95
+ `service install --max-concurrency <positive-integer>` only to add one back.
96
+
74
97
  This durable host uses a separate least-privilege `insights:inference`
75
98
  OAuth grant. It also keeps its ChatGPT subscription login in a dedicated private
76
99
  Codex home. Neither credential is copied from or widens the ordinary CLI or Codex
@@ -78,6 +101,9 @@ session. The per-user OS service starts immediately, starts again at login, and
78
101
  reconnects after sleep, network loss, or a worker exit. Stopping a VTX bot leaves
79
102
  the provider online and idle. Use `vtx inference-host run` only for foreground
80
103
  diagnostics. VTX logout/revoke and Codex logout are intentionally separate operations.
104
+ JSON foreground and service logs include safe concurrency, latency, token,
105
+ failure-code, and cooldown events without prompts, responses, or credentials.
106
+ Use `service logs --instance <name>` to isolate one subscription.
81
107
 
82
108
  Use `vtx inference-host --help` for command discovery. The VTX login verifies
83
109
  that the selected credential store can read back the exact saved grant. If an