Changelog

​

DevTools

• bricks devtools console list — reads a running app’s console output, covering log entries and exceptions, with an optional collection duration and JSON output. See commands.
• MESSAGE system actions without a title now reach the console too, instead of appearing only in the in-Simulator Logs panel.
• Timers keep running at full speed while bricks devtools drives the Simulator, so Generator Tick and other timer-driven generators no longer look frozen. See CTOR.

​

Buttress

• bricks buttress mcp-config — writes the .mcp.json entry an agent needs to reach a BRICKS Buttress server. See BRICKS Buttress.

​

Doctor

• bricks app doctor — config validation now checks item-Brick event maps, flagging malformed entries and dead keys left behind by older Short Edit writes. See bricks-ctor.

​

Breaking changes

• bricks auth login is now OAuth — it starts the browser sign-in flow. Passcode login moved to bricks auth login-workspace. See authentication.
• ctor project tooling moved into the CLI — @fugood/bricks-ctor no longer ships project tooling; the bricks ctor command group replaces it. Existing projects migrate automatically on bricks ctor postinstall, which updates package scripts, the dependency, and .mcp.json. See bricks-ctor.

​

Authentication

• Sign in with your BRICKS account — bricks auth login opens the browser using PKCE, with a --no-browser device-code flow for SSH and headless environments. bricks auth workspaces and bricks auth use-workspace then select the workspace.
• The workspace API accepts OAuth sign-ins with the same per-operation permissions as the web BRICKS Controller. Workspace-token auth remains fully supported for CI and automation.

​

ctor projects

• bricks ctor — init, postinstall, pull, push, deploy, compile, simulator, and mcp now live in the CLI. See commands.

​

Doctor

• bricks app doctor and bricks module doctor — one command runs config validation plus semantic lint rules that catch real bugs: data-update races, missing result parameters, out-of-bounds frames, covered pressables, unused data nodes, and more.

​

DevTools

• bricks devtools issue-token caches a workspace token per profile. CDP commands pick it up automatically, and scan and open show each device’s auth state. See local debugging.

​

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.