Skip to main content

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.

May 20, 2026
Release
v2.24.4

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.
May 13, 2026
Release
v2.24.3

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.
May 4, 2026
Release
v2.24.2

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.
April 29, 2026
Release
v2.24.1

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.
April 22, 2026
Release
v2.24.0

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.