1 files changed, 11 insertions, 1 deletions
diff --git a/README.md b/README.md
index 3c1d45f..8fd42bd 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,16 @@
 
 Hexai, the AI LSP for the Helix editor.
 
-At the moment this project is only in the bainstorming phase.
+At the moment this project is only in the brainstorming phase.
 
+## LLM provider
+
+Hexai exposes a simple LLM provider interface and uses OpenAI by default for
+code completion when `OPENAI_API_KEY` is present in the environment.
+
+- Required: set `OPENAI_API_KEY` to your OpenAI API key.
+- Optional: set `OPENAI_MODEL` (default: `gpt-4o-mini`).
+- Optional: set `OPENAI_BASE_URL` to point at a compatible endpoint.
+
+If no key is configured, Hexai will fall back to a basic, local completion.