Command Line Interface
Manage automations, scripts, run tests, view logs, download, watch, publish and more from the command line.
Commands
Type mesa
to get a list of available commands:
mesa export mesa push [params] mesa pull [params] mesa watch mesa install [version] mesa test mesa replay mesa logs [-v] [-n 50] Optional Parameters: -e, --env [value] : Environment to use (filename in ./config/). -a, --automation [value] : Automation key. Automatically determined by the mesa.json file if not specified. -f, --force : Force, overwrite config for inputs/outputs/storage. -n, --number [value] : Number. -v, --verbose : Verbose: Show log metadata.
Installing
With yarn
yarn global add mesa-cli
Or with NPM
npm install -g mesa-cli
Upgrading
To upgrade to the latest version
yarn global upgrade mesa-cli@latest
Configuring sites
Create a new directory with a config.yml file:
uuid: mystoreuuid key: J0lSB0PIuw145xhk610Ud6dLA7A****B7LnfUjaL
The config.yml file can be in your current working directory, or in ~/.mesa/config.yml
so you can run mesa
from any working directory.
uuid
is your myshopify.com subdomain: UUID.myshopify.com
key
is your site's Mesa Key from the bottom of the Reports tab of the Mesa Dashboard .
Optional parameter: api_url
.
Specifying environments
- Delete your global
~/.mesa/config.yml
file - Save configuration files in
~/.mesa/config
. For example:~/.mesa/config/mystoreuuid.yml
- Pass the environment with the
--env
or-e
flags, or by setting theENV
envvar:
mesa watch --env mystoreuuid mesa watch -e mystoreuuid ENV=mystoreuuid mesa watch export ENV=mystoreuuid && mesa watch
Editing Automations
To get started, export an automation to download the scripts and configuration into the current directory:
mesa export <automationkey>
Then use the utility functions to keep your local code in sync with Mesa:
mesa watch <...files> mesa push <...files> mesa pull <...files>
<...files>
can be:
Specific path(s) to files: tracktor/in-webhook.js tracktor/out-webhook.js
Or for multiple files: tracktor/*
Local development
To clone mesa-cli
locally and install it globally:
git clone git@github.com:shoppad/mesa-cli.git cd mesa-cli yarn link