@fugood/bricks-cli 2.24.0-beta.41 → 2.24.0-beta.45

package/README.md

@@ -23,9 +23,14 @@ bricks auth login-token -t <your-workspace-token>
 
 # Check connection status
 bricks auth status
+bricks auth status --json
+
+# Machine-readable environment check
+bricks doctor --json
 
 # List devices
 bricks device list
+bricks device resolve "Lobby"
 
 # Start interactive mode
 bricks interactive
@@ -77,7 +82,7 @@ bricks auth login <passcode> [-p profile-name]
 bricks auth login-token -t <token> [-p profile-name]
 
 # Check status
-bricks auth status
+bricks auth status [-j|--json]
 
 # List all profiles
 bricks auth list
@@ -92,6 +97,14 @@ bricks auth logout [-p profile-name] [--all]
 bricks auth set-url <url>
 ```
 
+### Doctor
+
+```bash
+# Check config, auth, workspace reachability, MCP availability
+bricks doctor
+bricks doctor --json
+```
+
 ### Configuration
 
 ```bash
@@ -113,16 +126,20 @@ bricks config show [-j|--json]
 # List all devices
 bricks device list [-k keyword] [-j|--json]
 
+# Resolve a device name or ID
+bricks device resolve <query> [-l limit] [-j|--json]
+
 # Get device details
 bricks device get <device-id> [-j|--json]
 
 # Bind a new device with passcode
 bricks device bind <passcode> [-n device-name]
+bricks device bind <passcode> [--dry-run] [-j|--json]
 
 # Control device
-bricks device control <device-id> <type> [-p payload]
-bricks device refresh <device-id>
-bricks device clear-cache <device-id>
+bricks device control <device-id> <type> [-p payload] [--dry-run] [-j|--json]
+bricks device refresh <device-id> [--dry-run] [-j|--json]
+bricks device clear-cache <device-id> [--dry-run] [-j|--json]
 bricks device screenshot <device-id>
 
 # Monitor devices (real-time polling)
@@ -137,6 +154,9 @@ Control types: `refresh`, `clear-cache`, `take-screenshot`, `system-menu`, `syst
 # List applications
 bricks app list [-k keyword] [-j|--json]
 
+# Resolve an application name or ID
+bricks app resolve <query> [-l limit] [-j|--json]
+
 # Get application details
 bricks app get <app-id> [-c|--composed] [-j|--json]
 
@@ -148,9 +168,13 @@ bricks app short-edit <app-id> -l '[{"shortId":"<subspace-short-id>","path":"pro
 
 # Bind/unbind devices
 bricks app bind <app-id> [-b device-ids] [-u device-ids]
+bricks app bind <app-id> [-b device-ids] [-u device-ids] [--dry-run] [-j|--json]
 
 # Trigger automation
 bricks app trigger <app-id> <test-id> [--play|--stop] [--setup-at-launch]
+
+# Preview a release without publishing
+bricks app release <app-id> -c <config-path-or-json> [--dry-run] [-j|--json]
 ```
 
 ### Module Management
@@ -159,6 +183,9 @@ bricks app trigger <app-id> <test-id> [--play|--stop] [--setup-at-launch]
 # List modules
 bricks module list [-k keyword] [-j|--json]
 
+# Resolve a module name or ID
+bricks module resolve <query> [-l limit] [-j|--json]
+
 # Get module details
 bricks module get <module-id> [-j|--json]
 
@@ -167,6 +194,9 @@ bricks module update <module-id> [-n name] [-d description] [-c config-json] [-f
 
 # Short edit module (requires valid shortIds from module config)
 bricks module short-edit <module-id> -l '[{"shortId":"<subspace-short-id>","path":"property.name","content":"value"}]'
+
+# Preview a release without publishing
+bricks module release <module-id> -c <config-path-or-json> [--dry-run] [-j|--json]
 ```
 
 ### Device Group Management
@@ -175,6 +205,9 @@ bricks module short-edit <module-id> -l '[{"shortId":"<subspace-short-id>","path
 # List device groups
 bricks group list [-j|--json]
 
+# Resolve a device group name or ID
+bricks group resolve <query> [-l limit] [-j|--json]
+
 # Get group details
 bricks group get <group-id> [-j|--json]
 
@@ -182,8 +215,8 @@ bricks group get <group-id> [-j|--json]
 bricks group devices <group-id> [-j|--json]
 
 # Dispatch action to all devices
-bricks group dispatch <group-id> <action>
-bricks group refresh <group-id>
+bricks group dispatch <group-id> <action> [--dry-run] [-j|--json]
+bricks group refresh <group-id> [--dry-run] [-j|--json]
 
 # Monitor group (real-time polling)
 bricks group monitor <group-id> [-i interval-seconds]
@@ -219,6 +252,7 @@ bricks media file <file-id> [-j|--json]
 bricks interactive
 # or
 bricks i
+# or just run `bricks` from a TTY
 ```
 
 The interactive mode provides a terminal UI built with [Ink](https://github.com/vadimdemedes/ink) for:
@@ -234,6 +268,8 @@ Controls:
 - `Esc`: Go back
 - `q`: Quit
 
+When `bricks` is run without arguments in a non-TTY context such as Codex, CI, or shell pipelines, it prints help instead of launching Ink.
+
 ### Workspace Info
 
 ```bash
@@ -249,7 +285,7 @@ Configuration is stored in `~/.bricks-cli/config.json`:
 - API endpoint configuration (prod/beta/dev)
 - Token storage
 
-Use `bricks config show` to view current settings or `bricks config endpoint` to switch environments.
+Use `bricks config show` to view current settings, `bricks config endpoint` to switch environments, or `bricks doctor --json` for a machine-readable health check.
 
 ## Development