Apps & Builds
Inspect applications and historical builds in your workspace.
The BuildShare CLI includes dedicated commands to inspect registered applications and browse build history.
buildshare app
Sub-commands for listing and inspecting mobile applications in your active workspace.
List Applications
List all applications registered in your workspace along with their package/bundle identifiers:
buildshare app listTo format the output as JSON for scripting:
buildshare app list --jsonSub-commands
| Sub-command | Description |
|---|---|
app list | List all apps in the current workspace with package IDs, platform types, and metadata |
Example Output
ID NAME PLATFORM PACKAGE ID BUILDS
app_android_prod My App (Android) Android com.example.myapp 24
app_ios_prod My App (iOS) iOS com.example.myapp.ios 18buildshare build
Sub-commands for querying uploaded builds and release history.
buildshare build list
Lists builds for a project.
Usage
buildshare build list [flags]Behavior
- Interactive Project Picker: If executed without
--appoutside a project directory, the CLI lists all your projects in a numbered menu and prompts you to select one. - Local Directory Auto-Detection: If executed inside a project containing
buildshare.jsonor.buildshare.yaml, it automatically detects that project'sprojectIdand lists its builds without requiring flags. - Direct Flag: Target a specific project directly with
--app <projectId>or--project <projectId>.
Examples
# Interactively choose project or auto-detect from local buildshare.json
buildshare build list
# Explicit project ID via --app
buildshare build list --app <projectId>
# Explicit project ID via --project
buildshare build list --project <projectId>
# Output formatted as JSON
buildshare build list --jsonFlags & Options
| Flag | Description |
|---|---|
--app <projectId> | Target a specific project ID directly |
--project <projectId> | Alias for --app <projectId> |
--json | Output builds as structured JSON for scripting and automation |
Example Output
BUILD ID VERSION CODE RELEASED SIZE DOWNLOADS
bld_982348a7b 1.4.0 42 2026-03-20 14:32 UTC 51.8 MB 14
bld_771821f0c 1.3.9 41 2026-03-18 09:15 UTC 51.2 MB 89