diff --git a/README.md b/README.md
index c8124a4..f1c7237 100644
--- a/README.md
+++ b/README.md
@@ -2,9 +2,34 @@
 
 `Anaxi` is Superhog's tool to perform Extract-Load (EL) syncs between our multiple Cosmos DB databases and our DWH.
 
+## How to use the tool
+
+*Note: the app has only been used so far in a Linux environment. Windows support is dubious.*
+
+### Install
+
+- Ensure you have Python 3.10>= and `poetry` installed.
+- Run `poetry install` to install dependencies.
+- Activate the project's virtual environment. You can use `poetry shell`.
+- Test that everything is working by running `anaxi smoke-test`. You should see a happy pig.
+
+### Set up credentials
+
+`anaxi` needs a few configs and secrets to run.
+
+Regarding Cosmos DB databases: `anaxi` expects to find a file called `cosmos-db.yml` in the path `~/.anaxi/cosmos-db.yml`. The file should specify one or more Cosmos DB databases, along with the required secrets to interact with them. You can check the example file in this repo named `example-cosmos-db.yml` to understand how to build this file. Once you've done that, you can check if any database is reachable with the `cosmos-db-healthcheck` command. See more in the `General Usage` section below.
+
+### General Usage
+
+You can run a healthcheck against any Cosmos DB database like this:
+
+```bash
+anaxis cosmos-db-healthcheck --cosmos-db-id <your-db-id>
+```
+
 ## Incremental scopes
 
-- [ ] Callable CLI app
+- [X] Callable CLI app
 - [ ] Env vars readable from file system
 - [ ] Healthchecks against Cosmos DB doable
 - [ ] Healthchecks against DWH doable
diff --git a/example-cosmos-db.yaml b/example-cosmos-db.yaml
new file mode 100644
index 0000000..503fa1d
--- /dev/null
+++ b/example-cosmos-db.yaml
@@ -0,0 +1 @@
+#TODO
\ No newline at end of file