The official CLI for TestApp.io app distribution

Upload your Android (APK) and iOS (IPA) apps directly from the command line.
Notify your team instantly. Get feedback faster.

curl -Ls https://github.com/testappio/cli/releases/latest/download/install | bash

Works on macOS (Intel & Apple Silicon) and Linux (x86_64, ARM). For Windows, see below.

• What is ta-cli?
• Installation
• Quick Start
• Commands
• Configuration
• Environment Variables
• CI/CD Integrations
• Examples
• Supported Platforms
• Updating
• Troubleshooting
• Support

ta-cli lets you upload app builds to TestApp.io without leaving your terminal. Perfect for:

• Local development - Quick uploads while coding
• CI/CD pipelines - Automated releases on every build
• Team collaboration - Notify testers instantly with each release

Features:

• Upload Android APK and iOS IPA files
• Automatic app info extraction (version, bundle ID, etc.)
• Git integration for release notes
• Team notifications
• Chunked uploads with automatic retry
• Cross-platform support

curl -Ls https://github.com/testappio/cli/releases/latest/download/install | bash

This installs to /usr/local/bin/ta-cli.

Download from Releases:

Rename to ta-cli.exe and add to your PATH, or run directly.

ta-cli version

ta-cli config

Follow the prompts to enter your credentials.

ta-cli publish

That's it! Your app is uploaded and your team is notified.

Upload your app to TestApp.io.

ta-cli publish [flags]

Interactive configuration wizard.

ta-cli config

Display version information.

ta-cli version

Generate shell autocompletion scripts.

# Bash
ta-cli completion bash > /etc/bash_completion.d/ta-cli

# Zsh
ta-cli completion zsh > "${fpath[1]}/_ta-cli"

# Fish
ta-cli completion fish > ~/.config/fish/completions/ta-cli.fish

Location: ~/.ta-cli.json

{
  "api_token": "your_api_token",
  "app_id": "your_app_id",
  "release": "both",
  "apk": "/path/to/app.apk",
  "ipa": "/path/to/app.ipa",
  "release_notes": "",
  "git_release_notes": true,
  "git_commit_id": false,
  "notify": true,
  "archive_latest_release": false
}

ta-cli publish --config=/path/to/custom-config.json

1. Command-line flags (highest priority)
2. Config file specified by --config
3. .ta-cli.json in current directory
4. ~/.ta-cli.json (default)

Use environment variables instead of config files (ideal for CI/CD):

Example:

export TESTAPPIO_API_TOKEN="your_token"
export TESTAPPIO_APP_ID="your_app_id"
ta-cli publish --apk=./app.apk --release=android

ta-cli works with any CI/CD platform that supports bash. Just install and run!

# 1. Install ta-cli
curl -Ls https://github.com/testappio/cli/releases/latest/download/install | bash

# 2. Upload your app
ta-cli publish \
  --api_token=$TESTAPPIO_API_TOKEN \
  --app_id=$TESTAPPIO_APP_ID \
  --apk=./app-release.apk \
  --release=android \
  --notify=true

For the best experience, use our dedicated integrations with built-in auto-updates:

We have detailed guides for each CI/CD platform:

View All Integrations →

ta-cli publish \
  --release=android \
  --apk=./app-release.apk \
  --notify=true

ta-cli publish \
  --release=ios \
  --ipa=./App.ipa \
  --notify=true

ta-cli publish \
  --release=both \
  --apk=./app-release.apk \
  --ipa=./App.ipa \
  --release_notes="Bug fixes and improvements" \
  --notify=true

ta-cli publish \
  --git_release_notes=true \
  --git_commit_id=true \
  --notify=true

ta-cli publish \
  --apk=./app-release.apk \
  --archive_latest_release=true \
  --notify=true

Re-run the install script to update to the latest version:

curl -Ls https://github.com/testappio/cli/releases/latest/download/install | bash

Check your current version:

ta-cli version

sudo rm /usr/local/bin/ta-cli
rm ~/.ta-cli.json  # Optional: remove config

The binary isn't in your PATH:

# Option 1: Restart your terminal
# Option 2: Add to PATH manually
export PATH=$PATH:/usr/local/bin
# Option 3: Use full path
/usr/local/bin/ta-cli version

1. Check internet connection
2. Verify credentials - Ensure API token and App ID are correct
3. Validate your file - Make sure the APK/IPA exists and isn't corrupted
4. Retry - The CLI has automatic retry with exponential backoff

• APK: Ensure it's a valid Android package with AndroidManifest.xml
• IPA: Ensure it contains Info.plist and a valid provisioning profile

Reset your configuration:

rm ~/.ta-cli.json
ta-cli config

• Run Command Prompt or PowerShell as Administrator if needed
• Use forward slashes or escaped backslashes in paths: C:/path/to/app.apk

For advanced integrations, see the TestApp.io API Documentation.

We welcome contributions! Please see our Contributing Guidelines for details.

Apache 2.0 - See LICENSE file for details.

Built with love by TestApp.io
Trusted by thousands of developers worldwide

Happy releasing! 🎉