diff --git a/README.md b/README.md
index bff3d462af8d8071b3594e7a9e5bf170b46cbebb..813d1d2f1fc44b00c4009cb70a4a05a988d8346b 100644
--- a/README.md
+++ b/README.md
@@ -20,6 +20,8 @@ See our [installation instructions]( https://aliby.readthedocs.io/en/latest/INST
 
 ### CLI
 
+If installed via poetry, you have access to a Command Line Interface (CLI)
+
  ```bash
 aliby-run --expt_id EXPT_PATH --distributed 4 --tps None
  ```
diff --git a/docs/source/INSTALL.md b/docs/source/INSTALL.md
index 55e0c3d70abceddd5b869e904c61054d8be461b2..b19b576e29f5d163a009e07d0fa5080608a2ebdc 100644
--- a/docs/source/INSTALL.md
+++ b/docs/source/INSTALL.md
@@ -62,7 +62,7 @@ For Windows, the simplest way to install it is using conda (or mamba). You can i
     $ \PATH\TO\POETRY\LOCATION\poetry install
 
   - MacOS
-  Under work (See issue https://github.com/ome/omero-py/issues/317)
+  For local access and processing, follow the same instructions as Linux. Remote access to OMERO servers depends on some issues in one of our depedencies being solved (See issue https://github.com/ome/omero-py/issues/317)
 
 ### Git version
 
@@ -71,7 +71,7 @@ Install [ poetry ](https://python-poetry.org/docs/#installation) for dependency
 In case you want to have local version:
 
     $ git clone git@gitlab.com/aliby/aliby.git
-    $ cd aliby  
+    $ cd aliby
     
  and then either
 
@@ -85,9 +85,9 @@ for a version with only local access, or
 
     $$ poetry install --with dev
 
-to install with compatibale versions of the development tools we use, such as black.
+to install with compatible versions of the development tools we use, such as black.
 
-This commands will automatically install the [ BABY ](https://gitlab.com/aliby/baby) segmentation software. Support for additional segmentation and tracking algorithms is under development.
+These commands will automatically install the [ BABY ](https://gitlab.com/aliby/baby) segmentation software. Support for additional segmentation and tracking algorithms is under development.
 
 ## Omero Server