From e61142c60c0b457fee18e55963e64a1208df5a30 Mon Sep 17 00:00:00 2001
From: Greyson Lalonde <greyson.r.lalonde@gmail.com>
Date: Wed, 6 May 2026 04:43:07 +0800
Subject: [PATCH] fix(cli): emit DeprecationWarning when crewai.cli is imported

---
 lib/crewai/src/crewai/cli/__init__.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/lib/crewai/src/crewai/cli/__init__.py b/lib/crewai/src/crewai/cli/__init__.py
index 90121677c..24c1e866a 100644
--- a/lib/crewai/src/crewai/cli/__init__.py
+++ b/lib/crewai/src/crewai/cli/__init__.py
@@ -1,4 +1,4 @@
-"""Backward-compat shim — re-export ``crewai_cli`` as ``crewai.cli``.
+"""Deprecated: use ``crewai_cli`` instead.
 
 The CLI was extracted into the standalone ``crewai-cli`` package. Legacy
 ``from crewai.cli.X import Y`` imports are intercepted here and resolved to
@@ -13,12 +13,20 @@ import importlib.abc
 import importlib.machinery
 import sys
 from types import ModuleType
+import warnings
 
 
 _PREFIX = "crewai.cli"
 _TARGET = "crewai_cli"
 
 
+warnings.warn(
+    "crewai.cli is deprecated; import from crewai_cli instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+
 class _ShimLoader(importlib.abc.Loader):
     """Returns an already-imported ``crewai_cli`` submodule without re-executing it."""