Overview

The Momentic CLI is configured on a per-project basis. A single project is defined by a configuration file ending in momentic.config.yaml. This special file tells Momentic what files to consider “in scope” when searching for Momentic entities, and also contains other global configuration such as environment and browser settings.

Users can initialize any number of projects in the same repository and even the same folder to achieve isolation between different teams — simply run the init command in the desired working directory.

If using source control, users should commit Momentic configuration files so that all team members share the same settings.

​

Working with projects

Momentic commands that interact with your local environment (e.g. app, run) will automatically attempt to infer the active project. Starting from the current working directory, the CLI will traverse the file system upwards until a valid momentic.config.yaml file is found.

In the case of ambiguity, or if you would like to choose a specific project, you can pass the -c / --config option with a path to a Momentic project configuration file. Please refer to the command reference for more information.

​

Customizing your project

Momentic project YAML files can be customized to facilitate easier test building, test sharing, credential management, and more. Please view the other guides in this section to learn how to tailor Momentic to your use case.