mergeway-cli init

Scaffold the directory layout and default configuration for a Mergeway workspace.

Synopsis: Scaffold the directory layout and default configuration for a Mergeway workspace.

Usage

mergeway-cli [global flags] init

mergeway-cli init targets the directory referenced by --root (default .) and does not accept positional arguments. Use mkdir/cd before running the command if you want to initialize a new folder.

Need a walkthrough after initialization? Continue with the Getting Started guide.

Example

mkdir blog-metadata
cd blog-metadata
mergeway-cli init

Output resembles:

Initialized repository at .

mergeway-cli init ensures a starter mergeway.yaml exists in the target directory. Add folders such as entities/ or data/ yourself once the project grows; keeping everything in a single file is perfectly valid. Re-run the command safely—it won’t overwrite existing files.

The default configuration contains:

# mergeway-cli configuration
mergeway:
  version: 1

entities: {}