diff --git a/README.md b/README.md
index 2193318b..24f2b2ef 100644
--- a/README.md
+++ b/README.md
@@ -85,7 +85,30 @@ rowboatx --agent=<agent-name> --input="xyz" --no-interactive=true
 ```bash    
 rowboatx --agent=<agent-name> --run_id=<run_id> # resume from a previous run
 ```
-     
+## Models support
+You can configure your models in `~/.rowboat/config/models.json`
+```json
+{
+  "providers": {
+    "openai": {
+      "flavor": "openai"
+    },
+    "anthropic": {
+      "flavor": "anthropic"
+    },
+    "google": {
+      "flavor": "google"
+    },
+    "ollama": {
+      "flavor": "ollama"
+    }
+  },
+  "defaults": {
+    "provider": "openai",
+    "model": "gpt-5"
+  }
+}
+```
 ## Rowboat Classic UI
 
 To use Rowboat Classic UI (not RowboatX), refer to [Classic](https://docs.rowboatlabs.com/).