diff --git a/doc/readme/dev-tools.md b/doc/readme/dev-tools.md
index 6106b4f6d..34838c7af 100644
--- a/doc/readme/dev-tools.md
+++ b/doc/readme/dev-tools.md
@@ -61,6 +61,20 @@ Fire up a Venice [Gitpod](https://gitpod.io/) workspace in your browser by openi
 VSCodium uses [Open VSX Registry](https://open-vsx.org/) as its marketplace.
 
 
+### Install & Upgrade
+
+If you are on a Mac and have [Homebrew](https://brew.sh/) installed:
+
+```
+brew install --cask vscodium
+```
+
+```
+brew upgrade --cask vscodium
+```
+
+
+
 ### Tips to start with
    
 **Adjust VSCodium "settings.json" to support Venice files**