> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Product updates and announcements for BRICKS CLI

<Update label="July 8, 2026" description="v2.24.11" tags={["Release"]}>
  ### DevTools

  * **`bricks devtools`** — adds runtime interaction commands for Preview / Simulator workflows, including text input and popup reset helpers. See [commands](/cli/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.
</Update>

<Update label="July 1, 2026" description="v2.24.10" tags={["Release"]}>
  ### Fixes

  * **`bricks device`** — shows N/A instead of NaN% when memory or disk usage is unavailable. See [commands](/cli/commands).
</Update>

<Update label="June 24, 2026" description="v2.24.9" tags={["Release"]}>
  ### 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](/cli/commands).
  * **`bricks group`** — `dispatch`, `refresh`, `devices`, and `monitor` no longer always fail; `dispatch` now reports the dispatched and device counts. See [commands](/cli/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 ("---").
</Update>

<Update label="June 17, 2026" description="v2.24.8" tags={["Release"]}>
  ### Data Bank

  * **`bricks data`** — manage Data Bank status, space keys, and properties, with JSON output and confirmation handling for write actions. See [commands](/cli/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](/cli/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](/cli/commands).
</Update>

<Update label="June 10, 2026" description="v2.24.7" tags={["Release"]}>
  ### 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](/cli/commands).
</Update>

<Update label="May 27, 2026" description="v2.24.5" tags={["Release"]}>
  ### 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](/cli/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.
</Update>

<Update label="May 20, 2026" description="v2.24.4" tags={["Release"]}>
  ### Share-app

  * **`bricks app share-info <id>`** — list a source app's selected releases. See [commands](/cli/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.
</Update>

<Update label="May 13, 2026" description="v2.24.3" tags={["Release"]}>
  ### 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](/cli/commands).

  ### Buttress

  * **`bricks buttress scan`** — discover LAN buttress-servers, with auth state, bound workspace, and per-generator hardware caps. See [commands](/cli/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](/foundation/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.
</Update>

<Update label="May 4, 2026" description="v2.24.2" tags={["Release"]}>
  ### desktop-acp-bridge

  * New `--ws` mode on `desktop-acp-bridge` exposes the [CTOR](/ctor) Desktop ACP socket over WebSocket for LAN clients, with optional Bearer-token authentication. See [commands](/cli/commands).
</Update>

<Update label="April 29, 2026" description="v2.24.1" tags={["Release"]}>
  ### Standalone distribution

  * New standalone CLI distribution with platform installers (macOS, Linux, Windows) — no Node.js required. See [authentication](/cli/authentication) and [commands](/cli/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`.
</Update>

<Update label="April 22, 2026" description="v2.24.0" tags={["Release"]}>
  ### Highlights — AI-agent workflows

  * **Machine-readable health checks** — new `bricks doctor` and `bricks auth status --json` for scriptable environment diagnostics. See [commands](/cli/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](/foundation/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](/cli/commands).
</Update>