diff --git a/crates/nu-cli/README.md b/crates/nu-cli/README.md
index 045a47a101..e0eca3c9bd 100644
--- a/crates/nu-cli/README.md
+++ b/crates/nu-cli/README.md
@@ -1,3 +1,7 @@
+This crate implements the core functionality of the interactive Nushell REPL and interfaces with `reedline`.
+Currently implements the syntax highlighting and completions logic.
+Furthermore includes a few commands that are specific to `reedline`
+
 ## Internal Nushell crate
 
 This crate implements components of Nushell and is not designed to support plugin authors or other users directly.