minitest-cli
Command-line interface for the Minitest testing platform for mobile and web apps.
Installation
One-liner (recommended)
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/minitap-ai/minitest-cli/main/install.sh | bash
Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/minitap-ai/minitest-cli/main/install.ps1 | iex"
Both scripts use uv if available, or install it automatically.
Other methods
uv (all platforms):
uv tool install minitest-cli
Homebrew (macOS):
brew install minitap-ai/tap/minitest-cli
uvx (zero-install, all platforms):
uvx --from minitest-cli minitest --help
From source:
git clone https://github.com/minitap-ai/minitest-cli.git
cd minitest-cli
uv sync
uv run minitest --help
Quick Start
# Authenticate
minitest auth login
# List your apps
minitest apps list
# Create a new app on your tenant
minitest apps create --name "My Mobile App" --platform ios --platform android
# Or create a web app target
minitest apps create --name "My Web App" --platform web --web-url https://example.com
# Upload native builds when testing iOS/Android apps
minitest --app <app-id> build upload ./app-release.apk
# Android App Bundle archives (.apks) are also accepted
minitest --app <app-id> build upload ./app-release.apks
# Run tests
minitest --app <app-id> run all --web
# or, for native lanes:
minitest --app <app-id> run all --ios-build <ios-build-id> --android-build <android-build-id>
Configuration
| Environment Variable | Description | Required |
|---|---|---|
MINITEST_TOKEN |
API authentication token | Yes (or use minitest auth login) |
MINITEST_APP_ID |
Default app ID | No (can use --app flag) |
MINITEST_API_URL |
testing-service base URL | No (defaults to production) |
MINITEST_APPS_MANAGER_URL |
apps-manager base URL (used by minitest apps create) |
No (defaults to production) |
MINITEST_INTEGRATIONS_URL |
minihands-integrations base URL (used to list tenants) | No (defaults to production) |
MINITEST_WEBAPP_URL |
Minitest webapp base URL (used for review links) | No (defaults to production) |
MINITEST_SUPABASE_URL |
Supabase project URL used for OAuth login | No (defaults to production) |
MINITEST_SUPABASE_PUBLISHABLE_KEY |
Supabase publishable (anon) key used for OAuth login | No (defaults to production) |
The recommended way to set these is to copy
.env.exampleto.env— the CLI loads.envautomatically. The shipped.env.examplealready targets the dev environment (see below).
Global Flags
| Flag | Description |
|---|---|
--json |
Output JSON to stdout (diagnostics go to stderr) |
--app <id-or-name> |
Target app for commands that require one |
--version |
Show CLI version |
--help |
Show help |
Commands
| Command | Description |
|---|---|
minitest auth |
Authentication management |
minitest apps |
App management |
minitest user-story |
User-story operations |
minitest df |
Draft features — branches of the test suite |
minitest flow-types |
List flow types, create/rename/delete custom ones |
minitest screens |
Inspect the screens exploration mapped for an app |
minitest build |
Native iOS/Android build management |
minitest run |
Test execution for mobile and web lanes |
minitest maintenance |
CLI-only test-flow maintenance against local code |
CLI-only maintenance
minitest maintenance lets a coding agent keep Minitest user stories in sync
without connecting GitHub. Run it from the app repository: the code stays on the
machine, while the CLI sends only proposed test-flow edits and the local HEAD SHA.
# Print the server-composed maintenance instructions for your coding agent
minitest maintenance --agent
# Agent workflow primitives
minitest --json maintenance context
minitest maintenance affected --file affected.json
minitest maintenance change --file change.json
minitest maintenance status --phase writing --message "Updating affected stories"
minitest maintenance complete --changed
# Apply proposed edits now, or open the web review queue
minitest maintenance apply
minitest maintenance apply --review
Exit Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Authentication error |
| 3 | Network / API error |
| 4 | Resource not found |
| 5 | Build rejected as invalid |
| 6 | Conflict — re-read, rebuild, retry once |
Using the Dev Environment
The shipped .env.example already targets the dev environment, so pointing the CLI at dev is just a matter of loading it. Copy it to .env once:
cp .env.example .env
The CLI loads .env automatically, so every command now runs against dev — no per-command environment variables needed:
minitest auth login # authenticates against dev, stores a dev-specific token
minitest apps list # runs against dev
To target production instead, either omit the .env file (the built-in defaults point at production) or comment out the dev values and uncomment the # Production lines in your .env.
Tip: You can still override any single variable inline for a one-off command, e.g.
MINITEST_API_URL=https://testing-service.dev.minitap.ai minitest apps list.
Development
# Install dependencies
uv sync --dev
# Run linter
uv run ruff check .
# Run formatter
uv run ruff format .
# Run type checker
uv run pyright
# Run tests
uv run pytest
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file minitest_cli-0.25.2.tar.gz.
File metadata
- Download URL: minitest_cli-0.25.2.tar.gz
- Upload date:
- Size: 196.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
896b9d9c6c7c770aafbf583f12ba215abc05f593c9a23063e440e5f9bb2b5447
|
|
| MD5 |
64e68190044d4a3bbb81c935df161d25
|
|
| BLAKE2b-256 |
adad1e45e0328f1bd713e724425679edc2b41fed5887623d3fe3101455228c07
|
Provenance
The following attestation bundles were made for minitest_cli-0.25.2.tar.gz:
Publisher:
release.yml on minitap-ai/minitest-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
minitest_cli-0.25.2.tar.gz -
Subject digest:
896b9d9c6c7c770aafbf583f12ba215abc05f593c9a23063e440e5f9bb2b5447 - Sigstore transparency entry: 2687450446
- Sigstore integration time:
-
Permalink:
minitap-ai/minitest-cli@dc94056acb465ada40342065a376483c02380550 -
Branch / Tag:
refs/tags/v0.25.2 - Owner: https://github.com/minitap-ai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@dc94056acb465ada40342065a376483c02380550 -
Trigger Event:
push
-
Statement type:
File details
Details for the file minitest_cli-0.25.2-py3-none-any.whl.
File metadata
- Download URL: minitest_cli-0.25.2-py3-none-any.whl
- Upload date:
- Size: 172.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
75d2176eec08fa421bc7e87036c58e74e395f97408f32d5f1d7fa6c85bb31b09
|
|
| MD5 |
13a9151c36d85260ee731011b4de212c
|
|
| BLAKE2b-256 |
bc9b7d680d34d6775565acae4dc0f4c0c01ee6bb040c871965db1aa165b7d1ab
|
Provenance
The following attestation bundles were made for minitest_cli-0.25.2-py3-none-any.whl:
Publisher:
release.yml on minitap-ai/minitest-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
minitest_cli-0.25.2-py3-none-any.whl -
Subject digest:
75d2176eec08fa421bc7e87036c58e74e395f97408f32d5f1d7fa6c85bb31b09 - Sigstore transparency entry: 2687450527
- Sigstore integration time:
-
Permalink:
minitap-ai/minitest-cli@dc94056acb465ada40342065a376483c02380550 -
Branch / Tag:
refs/tags/v0.25.2 - Owner: https://github.com/minitap-ai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@dc94056acb465ada40342065a376483c02380550 -
Trigger Event:
push
-
Statement type:
