diff --git a/core/core-cli-lib.el b/core/core-cli-lib.el
index 937af959c..5eed7b2e4 100644
--- a/core/core-cli-lib.el
+++ b/core/core-cli-lib.el
@@ -1,5 +1,10 @@
 ;;; core/core-cli-lib.el --- API+DSL for Doom's CLI framework -*- lexical-binding: t; -*-
 ;;; Commentary:
+;;
+;; The heart of Doom's CLI framework. This is safe to load in interactive
+;; sessions (for API access and syntax highlighting), but much of the API
+;; expects a noninteractive session, so take care when testing code!
+;;
 ;;; Code:
 
 (require 'seq)
diff --git a/core/core-cli.el b/core/core-cli.el
index 0d12ad4f2..a83fb43bc 100644
--- a/core/core-cli.el
+++ b/core/core-cli.el
@@ -1,9 +1,9 @@
 ;;; core/core-cli.el --- The heart of Doom's CLI framework -*- lexical-binding: t; no-byte-compile: t; -*-
 ;;; Commentary:
 ;;
-;; The heart of Doom's CLI framework. This is safe to load in interactive
-;; sessions (for API access and syntax highlighting), but much of the API
-;; expects a noninteractive session, so take care when testing code!
+;; The bootstrapper for Doom's CLI. This is *not* safe to load in interactive
+;; sessions as it has many side-effects. Loads `core-cli-lib' instead for API
+;; access and syntax highlighting.
 ;;
 ;;; Code: