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.
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-iddirectly).
App and module
bricks app/module release— accepts--nameto 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-updatereports 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-idand--validateto reject conflicting pushes. Generated projects ship a newbun update-appscript 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
-vas an alias for--version. bricks app/module new --init(andctor-init) treat--outputas the target directory when explicitly supplied.- Refuse to init a new project inside an existing CTOR project.
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
bunruntime when available, with automatic fallback tonode. - 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 doctorandbricks auth status --jsonfor scriptable environment diagnostics. See commands. resolvecommands — newresolvesubcommands for devices, apps, modules, and groups to look up canonical IDs by name or alias.--dry-runpreviews — 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, andruntime eval. See DevTools commands.