CLI

The Maeztro mz CLI is used to access, synchronize, and control a Maeztro application from a shell.

Logging In

Start by running mz login to log in to a Maeztro server. This creates a “login context” for that server which will be used for all new projects. This will auto-detect auth and SSL settings and prompt for any credentials or confirmation.
If you want to switch contexts or create a new one, you can mz login <context_id>.

The login context configuration is stored under ~/.maeztro, along with a local_encryption.key used to encrypt passwords and other sensitive information in the config files. These files can be edited directly if you prefer, with passwords set as plain-text. You can force plain-text by making the local_encryption.key be an empty file.

Once a project is initialized, its login context will be remembered. The current context is stored in the file login_context in <app_dir>/.mz_state/ for projects and ~/.maeztro/ for the default for new projects. Information on the context for the current directory, and all contexts, is available by running mz context and mz context list.

Help

The CLI has interactive help available by running mz help <command> or mz <command> --help, or mz help –options` for help on options.

Full list of commands

The full list of commands is available by running mz help. For convenience here, commonly used commands are:

  init              Initialize a folder for use with Maeztro
  status            Show status of a Maeztro application (default command)
  update            Update state and files which might be out-of-date
  apply             Activate unapplied files and refresh data

Other available commands are:

  context           Show or update available login contexts
  discard           Discard unapplied changes, locally and/or at server
  login             Connect to a Maeztro server and configure it as the default login context
  refresh           Refresh data from external sources and with the Maeztro server
  run               Run all recommended Maeztro actions
  sync              Synchronize files and state with the Maeztro server