@loongphy/codex-auth-linux-x64 0.3.0-alpha.8 → 0.3.0

package/README.md

@@ -47,6 +47,21 @@ After that, you can use `codex-auth login`, or `codex-auth login --device-auth`
 
 Detailed command documentation lives in [docs/commands/README.md](./docs/commands/README.md).
 
+> [!NOTE]
+> This documentation is based on **v0.3.x**. Some commands described here may not be available in the current release.
+>
+> To try the latest features, please install the alpha version via:
+>
+> ```bash
+> npm install -g @loongphy/codex-auth@next
+> ```
+> 
+> If you want to downgrade to **v0.2.x**, you may need to manually update the `~/.codex/accounts/registry.json`:
+>
+> ```json
+> "schema_version": 3
+> ```
+
 ### Account Management
 
 | Command | Description |
@@ -58,6 +73,8 @@ Detailed command documentation lives in [docs/commands/README.md](./docs/command
 | [`codex-auth remove [--live] [--api\|--skip-api]`](./docs/commands/remove.md) | Remove accounts interactively |
 | [`codex-auth remove <query> [<query>...]`](./docs/commands/remove.md) | Remove accounts by selector |
 | [`codex-auth remove --all`](./docs/commands/remove.md) | Remove all stored accounts |
+| [`codex-auth alias set <query> <alias>`](./docs/commands/alias.md) | Set an alias for an account |
+| [`codex-auth alias clear <query>`](./docs/commands/alias.md) | Clear the alias for an account |
 
 ### Import and Maintenance
 
@@ -141,6 +158,10 @@ Verify with:
 codex exec "say hello"
 ```
 
+## Build a GUI with JSON
+
+If you are building a GUI on top of the current `codex-auth` client, use the supported `--json` command variants to receive machine-readable results. See the [JSON API documentation](./docs/json-api.md) for supported commands and the compatibility contract.
+
 ## Disclaimer
 
 This project is provided as-is and use is at your own risk.
@@ -148,8 +169,12 @@ This project is provided as-is and use is at your own risk.
 **Usage Data Refresh Source:**
 `codex-auth` supports two sources for refreshing account usage/usage limit information:
 
-1. **API (default):** The tool makes direct HTTPS requests to OpenAI's endpoints using your account's access token. This enables both usage refresh and team name refresh. npm installs already satisfy the runtime requirement.
+1. **API (default):** The tool makes direct HTTPS requests to OpenAI's endpoints using your account's access token. This enables both usage refresh and team name refresh. `curl` must be available at runtime.
 2. **Local-only:** With per-command `--skip-api`, the tool scans local `~/.codex/sessions/*/rollout-*.jsonl` files for usage data and skips team name refresh API calls. This mode is safer, but it can be less accurate because recent Codex rollout files often contain `rate_limits: null`, so the latest local usage limit data may lag by several hours.
 
 **API Call Declaration:**
-By using the default API-backed refresh, this tool will send your ChatGPT access token to OpenAI's servers, including `https://chatgpt.com/backend-api/wham/usage` for usage limit and `https://chatgpt.com/backend-api/accounts/check/v4-2023-04-27` for team name. This behavior may be detected by OpenAI and could violate their terms of service, potentially leading to account suspension or other risks. The decision to use this feature and any resulting consequences are entirely yours.
+By using the default API-backed refresh, this tool will send your ChatGPT access token to OpenAI's servers for usage limit and team name refresh. The exact endpoints are:
+- `GET https://chatgpt.com/backend-api/wham/usage`
+- `GET https://chatgpt.com/backend-api/accounts`
+
+This behavior may be detected by OpenAI and could violate their terms of service, potentially leading to account suspension or other risks. The decision to use this feature and any resulting consequences are entirely yours.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loongphy/codex-auth-linux-x64",
-  "version": "0.3.0-alpha.8",
+  "version": "0.3.0",
   "description": "@loongphy/codex-auth binary for linux x64",
   "license": "MIT",
   "repository": {