Overview
Complete reference for installing, configuring, and using the BuildShare CLI to distribute mobile app builds from your terminal or CI/CD pipeline.
The BuildShare CLI is a compiled Go binary that lets you upload, manage, and share Android APK and iOS IPA builds directly from your terminal. It has zero runtime dependencies — no Node.js, Python, Ruby, or package manager required.
Zero Dependencies
The CLI is distributed as a single standalone executable compiled natively for your operating system and architecture. No package managers or runtime runtimes are required.
Key Features
- Single standalone binary — runs natively on macOS (Apple Silicon & Intel), Linux (x86_64 & ARM64), and Windows (x64).
- Automatic detection — OS and CPU architecture are detected automatically during one-line installation.
- Headless CI mode — native
--ciand--jsonflags with structured JSON output and standardized exit codes. - Token-based authentication — seamless integration with GitHub Actions, GitLab CI, Bitbucket, and custom scripts via
BUILDSHARE_TOKEN. - Real-time upload progress — interactive upload progress tracking with instant, shareable OTA download links generated upon completion.
Getting Started
Installation
One-line install scripts for macOS, Linux, and Windows.
Quick Start
3-step guide: authenticate, upload builds, and view apps.
Upload Builds
Upload APK and IPA files with custom flags and release notes.
CI/CD Integration
Automate build uploads in GitHub Actions, GitLab CI, and Bitbucket.
Command Reference Summary
| Command | Description |
|---|---|
buildshare login | Authenticate interactively or via personal access token |
buildshare logout | Revoke credentials and remove stored local authentication |
buildshare whoami | View currently authenticated user and active workspace |
buildshare upload <file> | Upload Android APK or iOS IPA build with real-time progress |
buildshare app list | List all applications and bundle IDs in your workspace |
buildshare build list | Inspect recent builds and releases for a given application |
buildshare version | Print installed version number, commit hash, and build timestamp |