diff --git a/README.md b/README.md
index 7ca6f963..c846ffaf 100644
--- a/README.md
+++ b/README.md
@@ -99,6 +99,8 @@ const answer = await chat.ask("What patterns do you see in customer behavior?")
 // → AI-powered insights from your knowledge graph!
 ```
 
+<sub>**How it works:** Combines vector embeddings for semantic understanding • Graph relationships for connection patterns • Metadata filtering for structured analysis • Optional LLM for natural language insights</sub>
+
 **One line. Zero complexity. Optional LLM for genius-level responses.**  
 [📖 **Learn More About Brainy Chat**](BRAINY-CHAT.md)
 
diff --git a/package-lock.json b/package-lock.json
index f9609d39..e9c5e259 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -23,7 +23,7 @@
         "uuid": "^9.0.1"
       },
       "bin": {
-        "cortex": "bin/cortex.js"
+        "brainy": "bin/brainy.js"
       },
       "devDependencies": {
         "@types/express": "^5.0.3",