@todesktop/cli 1.19.0-1 → 1.19.0-3

package/README.md

@@ -48,7 +48,7 @@ Create a `todesktop.json` file in the root of your Electron project.
 
 ```json
 {
-  "$schema": "https://unpkg.com/@todesktop/cli@1.19.0/schemas/schema.json",
+  "$schema": "https://unpkg.com/@todesktop/cli@1.19.0-3/schemas/schema.json",
   "schemaVersion": 1
   "id": "your-todesktop-id",
   "icon": "./desktop-icon.png",
@@ -242,6 +242,19 @@ We also support:
 - `todesktop --help`. Shows the help documentation.
 - `todesktop --version`. Shows the current version of the CLI.
 
+### Global Options
+
+The following options can be used with any command:
+
+- `todesktop --config-dir <path>`. Specify a custom directory for storing CLI
+  configuration and credentials. This overrides the default system config
+  directory. Can also be set via the `TODESKTOP_CONFIG_DIR` environment
+  variable.
+- `todesktop --ephemeral`. Do not persist any configuration or credentials to
+  disk. All config is stored in memory only for the duration of the command.
+  This is useful for CI environments where credentials are provided via
+  environment variables and you don't want anything written to disk.
+
 ## Introspection & breakpoints
 
 Interactive introspection lets you open a shell on a live build agent and pause
@@ -297,6 +310,27 @@ TODESKTOP_ACCESS_TOKEN=accessToken
 TODESKTOP_EMAIL=email
 ```
 
+### Ephemeral mode for CI
+
+In CI environments, you may want to prevent the CLI from writing any credentials
+or configuration to disk. Use the `--ephemeral` flag to store all config in
+memory only:
+
+```sh
+todesktop build --ephemeral
+```
+
+You can also specify a custom config directory if needed (e.g., for isolated
+build environments):
+
+```sh
+todesktop build --config-dir /tmp/todesktop-config
+# Or via environment variable
+TODESKTOP_CONFIG_DIR=/tmp/todesktop-config todesktop build
+```
+
+### Async builds with webhooks
+
 If you need to run a build in the background, you can use the `--async` flag. To
 get notified when the build is finished you can optionally specify a webhook URL
 which will receive a POST request with the build data:
@@ -379,7 +413,7 @@ To enable JSON validation and IntelliSense for your `todesktop.json` file in com
 - For example, if using a hosted version of the schema:
   ```json
   {
-    "$schema": "https://unpkg.com/@todesktop/cli@1.19.0/schemas/schema.json",
+    "$schema": "https://unpkg.com/@todesktop/cli@1.19.0-3/schemas/schema.json",
     "id": "your-todesktop-id"
   }
   ```
@@ -1598,6 +1632,8 @@ Now, when we build your app on ToDesktop servers, it will also run your custom
 - dc5fe40: Add `todesktop build --introspect` flag and
   `todesktop introspect [buildId]` command for interactive shell access to
   in-progress builds
+- 577d4ad: Add `--config-dir` and `--ephemeral` global flags for custom config
+  storage
 
 ### 1.18.3