Introduction
The nimbus-cli is a command line tool for interacting with the Nimbus SDK embedded in Mozilla's mobile applications.
It aims to provide a uniform way of interacting with an app, no matter what the app or the platform.
If you're looking for installation instructions, start here.
Goals
The principle goals for the nimbus-cli is to make testing and developing experiments easier:
- to force the app to enroll into a given experiment, regardless of where the experiment is in its lifecycle
- to find the names of experiments and branches
- to reset the app back to a just-installed state
- to allow more concise Steps to Reproduce in bug reports.
Additionally, it is useful to be developers to investigate problems with the apps and with the internal state of the Nimbus SDK:
- to test feature configurations without needing to interact with experimenter
- to validate experiments and feature configurations against the app's feature manifest
- to display and capture the logs of the device
- to display the state of the Nimbus SDK in the logs.
Non-goals
The tool works by using the existing tooling provided by platform vendors (for Android, adb; for iOS, simctl) to communicate with an installed app on a device, emulator or simulator.
No attempt is made to help installing or uninstalling of the apps on to devices.
There is limited support for working with iOS devices.