codexuse-cli 6.2.0 → 6.2.2

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 (4) hide show
  1. package/README.md +16 -15
  2. package/dist/index.js +6381 -6000
  3. package/dist/index.js.map +1 -1
  4. package/package.json +11 -2
package/README.md CHANGED
@@ -1,12 +1,13 @@
1
1
  # CodexUse CLI
2
2
 
3
- Command-line control for CodexUse profiles: switch Codex accounts, run Codex under a chosen
4
- profile, and manage Account Pool, licenses, and manual cloud sync. Shares local state with
5
- the CodexUse desktop app on the same machine.
3
+ Command-line companion to the CodexUse desktop app. List your saved Codex accounts with
4
+ their headroom, open Codex under a chosen account, and manage Account Pool, licenses, and
5
+ manual Cloud Sync. Shares local state with the CodexUse desktop app on the same machine.
6
+ The `profile` command group is the CLI's name for a saved account.
6
7
 
7
- The CLI has a separate macOS, Windows, and Linux route. Codex App window control,
8
- provider setup, and the desktop Account Pool runtime require the Apple Silicon
9
- macOS desktop app. The CLI does not provide desktop feature parity.
8
+ The CLI runs on macOS, Windows, and Linux. Codex windows, Work runs, custom-model
9
+ account setup, and the desktop Account Pool runtime require the Apple Silicon macOS
10
+ desktop app. The CLI does not provide desktop feature parity.
10
11
 
11
12
  Install (npm):
12
13
  ```bash
@@ -56,10 +57,10 @@ codexuse sync push [--passphrase-stdin]
56
57
 
57
58
  Notes:
58
59
  - Requires Codex CLI on PATH for `profile add` / `refresh` (runs `codex login` in an isolated temporary home).
59
- - Custom-provider profiles — a profile that runs a non-OpenAI model inside the Codex App — appear in `profile list` and `profile current`; `profile switch` and `run` accept them.
60
- - A custom-provider profile reads `not metered` instead of rate-limit usage: it uses no OpenAI quota and you pay your provider directly.
60
+ - Custom-model accounts (an account that runs a non-OpenAI model inside the Codex app) appear in `profile list` and `profile current`; `profile switch` and `run` accept them.
61
+ - A custom-model account reads `not metered` instead of rate-limit usage: it uses no OpenAI quota and you pay your provider directly.
61
62
  - Create provider connections and models in the desktop app under Settings → Model Providers. The CLI does not create them. Reference: https://codexuse.com/docs/providers/
62
- - `profile cli` runs Codex in the profile's permanent isolated home without changing the active global login.
63
+ - `profile cli` runs Codex in the account's permanent isolated home without changing the active global login.
63
64
  - `workspace bind` stores private machine-local path bindings; `run` selects the nearest bound ancestor.
64
65
  - `run --profile` warns when it overrides a binding; add `--strict` to reject mismatches.
65
66
  - `profile list` reads live rate-limit usage via Codex CLI by default.
@@ -71,11 +72,11 @@ Notes:
71
72
  - Account Pool settings are shared with the desktop app on the same machine.
72
73
  - Account Pool API keys and live sessions belong to the desktop app runtime store.
73
74
  - `profile autoroll` requires Pro or an active trial.
74
- - `profile autoroll` uses live rate-limit usage and switches when current remaining usage is at or below the `% left` threshold.
75
- - `profile autoroll` defaults to saved desktop auto-roll switch threshold when available (else 5% left).
76
- - Use `--switch-left=NN` to set the switch threshold by percent left.
77
- - Profile switches synchronize an already-running managed ChatGPT/Codex app by default without launching a closed app.
75
+ - `profile autoroll` uses live rate-limit usage and rolls to another account when current remaining usage is at or below the `% left` threshold.
76
+ - `profile autoroll` defaults to the saved desktop auto-roll threshold when available (else 5% left).
77
+ - Use `--switch-left=NN` to set the roll threshold by percent left.
78
+ - `profile switch` synchronizes an already-running managed Codex window by default without opening a closed one.
78
79
  - If that app is generating, the command waits for its completion event and then finishes synchronization without polling.
79
- - `--activate-codex` also launches a closed app; `--no-activate-codex` disables app synchronization.
80
- - `--take-control` explicitly permits verified replacement of an unmanaged app window.
80
+ - `--activate-codex` also opens a closed Codex window; `--no-activate-codex` disables window synchronization.
81
+ - `--take-control` explicitly permits verified replacement of a Codex window that CodexUse did not open.
81
82
  - `profile autoroll --watch` keeps polling at `--interval` seconds (default `30`).