# Grey Matter VSCode Extension

[The Grey Matter VSCode extension](https://marketplace.visualstudio.com/items?itemName=greymatter.greymatter) provides user shortcuts to generate configuration files for a Grey Matter based service mesh.

## Prerequisites

* `greymatter` CLI version 2.x installed in your PATH
* Template source such as [pathogen-greymatter](https://github.com/greymatter-io/pathogen-greymatter)

## Usage Instructions

1. Open the command palette (Ctrl+Shift+P on Windows and Linux, Cmd+Shift+P on OS X) and search for Grey Matter. Alternatively, you can right click on any folder in the Explorer.

![Generate Grey Matter Configurations via the Command Pallete](https://1676458320-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LsNFVozLgvw3NDMzxBg%2Fsync%2F9277d949a5dd0a70a8fc4d12ec96d8824df7c2d2.png?generation=1605725747679398\&alt=media)

1. Select "Generate Grey Matter Configurations"
2. Enter the template source URL, e.g. `git@github.com:greymatter-io/pathogen-greymatter.git//service`. The extension will remember template sources previously used within the workspace.

![Enter the template source URL](https://1676458320-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LsNFVozLgvw3NDMzxBg%2Fsync%2F2366c00588000e269cc86af16eea766d83c2e5e2.png?generation=1605725747351860\&alt=media)

1. Answer the prompts for template values. Once all variables have been resolved, the resulting configuration files will be written to the current workspace directory, or a folder if the extension was invoked from the context menu.

![Generated configurations are written to disk](https://1676458320-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LsNFVozLgvw3NDMzxBg%2Fsync%2Ff0cd55484d622c8d306aa979549a39ae6914bb0d.png?generation=1605725747147298\&alt=media)