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).
- Platform-based uploads — zero-config builds upload with
buildshare upload androidandbuildshare upload iospowered by auto-discoveredbuildshare.jsonorbuildshare.yaml. - Automatic detection — OS and CPU architecture are detected automatically during one-line installation; build folders and Git branches auto-detected during
buildshare init. - 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 automatic email delivery to your team and testers upon completion.
Getting Started
Installation
One-line install scripts for macOS, Linux, and Windows.
Quick Start
Guided flow: authenticate, initialize project, and upload builds.
Project Init
Link workspace and configure platform build folders.
Upload Builds
Upload APK and IPA files with platform-based detection and notes.
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 init | Link project workspace, configure build paths, and generate buildshare.json |
buildshare upload <android|ios|file> | Upload platform build or binary file 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 |
buildshare --version (-V, -v) | Quick version string display |