MultiTool CLI: overview

The MultiTool CLI is a command-line tool used to trigger and manage canary deployments. It connects to your MultiTool app account to safely roll out new versions of your services.

The MultiTool CLI can run either locally or in CI pipelines, and communicates with the MultiTool app to coordinate each deployment. Once you’ve configured your application in the MultiTool app, the MultiTool CLI can initiate a rollout by passing the relevant parameters — including the workspace, application name, and a zipped build artifact — using the multi run command.

During a deployment, the MultiTool CLI:

  • starts the canary rollout using configuration defined in the MultiTool app

  • reports runtime metrics from your service to evaluate rollout health

  • manages traffic shifting between baseline and canary versions

  • checks for rollout status from the MultiTool app and responds accordingly

The CLI requires valid AWS credentials and permissions to interact with your applications. For details, see Permissions.

To get started with installation, see Installation. For deployment instructions, see the Quickstart.

MultiTool CLI is open source under the MIT license, and contributions are welcome via pull request. You can also file issues or feature requests in the wack/multitool GitHub repository.