diff --git a/README.md b/README.md
index ba239afa..70f73af6 100644
--- a/README.md
+++ b/README.md
@@ -147,6 +147,11 @@ suspected vulnerabilities.
 
 ## Command line
 
+This repository is the home of the supported native `mdbase` CLI. It replaces
+the retired TypeScript CLI; TypeScript SDK packages remain supported libraries,
+not command-line implementations. CLI binaries follow mdbase connect's own beta
+release cadence and are not version-locked to the core and adapter RC train.
+
 The desktop app includes the unified `mdbase` CLI and background daemon. The
 same native executable is also published as a standalone headless archive for
 Linux, macOS, and Windows. Direct collection commands are top-level; identity,
diff --git a/docs/unified-cli.md b/docs/unified-cli.md
index 9d184c52..6db2158b 100644
--- a/docs/unified-cli.md
+++ b/docs/unified-cli.md
@@ -4,6 +4,10 @@
 
 The ecosystem ships one native command named `mdbase`.
 
+mdbase connect is the source and distribution home of this supported CLI. Its
+native binaries follow Connect's independent beta cadence; a core, runtime, or
+adapter release candidate does not imply a new Connect beta.
+
 ```text
 mdbase <data-command>
 mdbase connect <control-command>