Changelog

​

DevTools

• bricks devtools — adds runtime interaction commands for Preview / Simulator workflows, including text input and popup reset helpers. See commands.

​

Fixes

• bricks media upload — still uploads files when --concurrency is 0, negative, or invalid, falling back to serial execution instead of reporting a false success.
• bricks al screenshots — shows an exact epoch-ms --ts value so listed screenshots can be downloaded without timestamp rounding failures.

​

Fixes

• bricks device — shows N/A instead of NaN% when memory or disk usage is unavailable. See commands.

​

Fixes

• bricks app share-new — no longer fails with an “Unknown argument” error, so it can create an application from a shared version. See commands.
• bricks group — dispatch, refresh, devices, and monitor no longer always fail; dispatch now reports the dispatched and device counts. See commands.
• bricks app get — now correctly shows a locked application as locked.
• Streamed event data is no longer dropped when an event value contains three consecutive hyphens (”---”).

​

Data Bank

• bricks data — manage Data Bank status, space keys, and properties, with JSON output and confirmation handling for write actions. See commands.

​

DevTools

• bricks devtools storage — inspect System storage, Data Bank stores, Generator cache, and Generative Media cache with filters, paging, and full-value output. See commands.

​

App validation

• bricks app check-config — now validates Data Calculation references and PROPERTY_BANK_EXPRESSION strings by default, with --no-validate-expressions available when needed. See commands.

​

Resource management

• bricks app remove, bricks device remove, and bricks module remove — remove the corresponding resources from a workspace, with dry-run preview and JSON output support. See commands.

​

DevTools

• bricks devtools — accepts host:port directly via -a host:port, defaults --address to 127.0.0.1, and improves tap response on devices with non-standard pixel ratios. See commands.

​

Share-app

• bricks app share-info / share-new — work against v2.24.5+ workspaces. The workspace-scoped GraphQL field that bricks-cli relies on was previously missing on the workspace API.

​

Share-app

• bricks app share-info <id> — list a source app’s selected releases. See commands.
• bricks app share-new — create an application from a shared release version (--app-id + --version, or --version-id directly).

​

App and module

• bricks app/module release — accepts --name to rename in the same request.

​

Self-update

• bricks update-cli — new command for in-place self-update across npm, bun, and standalone-binary installs. --check-update reports availability without installing. See commands.

​

Buttress

• bricks buttress scan — discover LAN buttress-servers, with auth state, bound workspace, and per-generator hardware caps. See commands.

​

App and module updates

• bricks app/module update — accepts --last-commit-id and --validate to reject conflicting pushes. Generated projects ship a new bun update-app script that pushes config changes without bumping the release version, with auto-derived conflict guards based on the project’s git state.

​

DevTools

• Emit the HTTP CDP frontend URL by default; mark devtools:// as legacy. See Local debugging.
• Accept devtools flags placed before subcommands.

​

Other

• Support -v as an alias for --version.
• bricks app/module new --init (and ctor-init) treat --output as the target directory when explicitly supplied.
• Refuse to init a new project inside an existing CTOR project.

​

desktop-acp-bridge

• New --ws mode on desktop-acp-bridge exposes the CTOR Desktop ACP socket over WebSocket for LAN clients, with optional Bearer-token authentication. See commands.

​

Standalone distribution

• New standalone CLI distribution with platform installers (macOS, Linux, Windows) — no Node.js required. See authentication and commands for installation prerequisites.
• Prefers the bun runtime when available, with automatic fallback to node.
• Unix install directory moved to ~/.bricks-cli/bin.
• Auto-adds the install directory to your shell rc when missing from PATH.

​

Highlights — AI-agent workflows

• Machine-readable health checks — new bricks doctor and bricks auth status --json for scriptable environment diagnostics. See commands.
• resolve commands — new resolve subcommands for devices, apps, modules, and groups to look up canonical IDs by name or alias.
• --dry-run previews — preview the effect of live write commands before executing: device control, device bind, device refresh, device clear-cache, app bind, app release, module release, group dispatch, group refresh.
• Activity Log and device metrics — query Activity Log entries and device metrics from both the CLI and the built-in MCP server.
• Safe startup in non-TTY contexts — prints help instead of rendering the Ink UI when stdout is not a TTY, keeping CI and pipe invocations predictable.

​

DevTools

• bricks devtools — new subcommands for terminal-based inspection of running BRICKS applications: screenshot, brick tree, brick query, input tap, input type, network list, network get, storage, and runtime eval. See DevTools commands.