顶层是一个 click group，子命令挂在它下面（crewai_cli/cli.py:101）：

# crewai_cli/cli.py:101
@click.group()
@click.version_option(_get_cli_version())      # crewai --version
def crewai() -> None:
    """Top-level command group for crewai."""

# :138 一个子命令的样子
@crewai.command()
@click.argument("type", required=False, default=None, type=click.Choice(["crew", "flow"]))
@click.argument("name", required=False, default=None)
@click.option("--provider", type=str, help="The provider to use for the crew")
@click.option("--classic", is_flag=True, help="Use classic Python/YAML project structure")
def create(type, name, provider, skip_provider=False, classic=False, declarative=False):
    """Create a new crew, or flow."""
    ...

入口在 pyproject 里声明（lib/crewai/pyproject.toml:147）：

# pyproject.toml:147
[project.scripts]
crewai = "crewai_cli.cli:crewai"      # 命令 crewai → 指向 crewai() 这个 group

create 支持 crew/flow、经典/JSON/声明式多种模板（crewai_cli/cli.py:155）：

# crewai_cli/cli.py:155
def create(type, name, provider, skip_provider=False, classic=False, declarative=False):
    """Create a new crew, or flow."""
    dmn_mode = is_dmn_mode_enabled()
    if not type:
        if dmn_mode:
            raise click.UsageError("TYPE is required when CREWAI_DMN is set. ...")
        ...      # 交互式补问 type/name
    # 最终委托给 create_crew.py / create_flow.py 拷贝模板、替换项目名

生成的结构正是 Day 55 学的 @CrewBase 布局：

my_crew/
├── pyproject.toml            # 依赖 + [project.scripts] run_crew/train/...
├── src/my_crew/
│   ├── crew.py               # @CrewBase 类：@agent/@task/@crew
│   ├── main.py               # 入口：kickoff()
│   └── config/
│       ├── agents.yaml       # 角色/目标/背景（Day 55 的花名册）
│       └── tasks.yaml        # 任务描述（任务单）

run 命令解析参数后转交 run_crew（crewai_cli/cli.py:523）：

# crewai_cli/cli.py:523
def run(trained_agents_file, definition, inputs):
    """Run the Crew or Flow."""
    if trained_agents_file is not None and definition is not None:
        raise click.UsageError("--filename can only be used when running crews")
    run_crew(trained_agents_file=trained_agents_file, definition=definition, inputs=inputs)

而真正执行是在 uv 环境里跑一个脚本（crewai_cli/run_crew.py:740）：

# crewai_cli/run_crew.py:740
def _execute_uv_script(script_name, *, entity_type, trained_agents_file=None):
    """Execute a project script through uv."""
    command = ["uv", "run", script_name]                       # 例：uv run run_crew
    env = build_env_with_all_tool_credentials()                # 注入工具鉴权环境变量
    if trained_agents_file:
        env[CREWAI_TRAINED_AGENTS_FILE_ENV] = trained_agents_file
    try:
        subprocess.run(command, capture_output=False, text=True, check=True, env=env)  # ★子进程
    except subprocess.CalledProcessError as e:
        _handle_run_error(e, entity_type)                      # 转成友好错误提示
    except Exception as e:
        click.echo(f"An unexpected error occurred: {e}", err=True)

train 也是起 uv 子进程，但多了参数校验（crewai_cli/train_crew.py:6）：

# crewai_cli/train_crew.py:6
def train_crew(n_iterations: int, filename: str) -> None:
    """Train the crew by running a command in the UV environment."""
    command = ["uv", "run", "train", str(n_iterations), filename]
    try:
        if n_iterations <= 0:
            raise ValueError("The number of iterations must be a positive integer.")
        if not filename.endswith(".pkl"):
            raise ValueError("The filename must not end with .pkl")   # 注意这条校验（见边界）
        result = subprocess.run(command, capture_output=False, text=True, check=True)
        ...
    except subprocess.CalledProcessError as e:
        click.echo(f"An error occurred while training the crew: {e}", err=True)

replay 用 task_id 从中间步骤重跑（crewai_cli/cli.py:274）：

# crewai_cli/cli.py:254
@crewai.command()
@click.option("-t", "--task_id", ...)                    # 从哪个任务重放
@click.option("-f", "--trained_agents_file", ...)
def replay(task_id, trained_agents_file):
    """Replay the crew execution from a specific task."""
    ...

reset-memories 用一堆 flag 精细控制清什么（crewai_cli/cli.py:311）：

# crewai_cli/cli.py:311
@crewai.command()
@click.option("-m", "--memory", is_flag=True, help="Reset MEMORY")
@click.option("-kn", "--knowledge", is_flag=True, help="Reset KNOWLEDGE storage")
@click.option("-a", "--all", is_flag=True, help="Reset ALL memories")
def reset_memories(...):                                  # :342
    """Reset the crew memories (long, short, entity, ...)."""

deploy 本身又是一个子命令组（crewai_cli/cli.py:572）：

# crewai_cli/cli.py:572
@crewai.group()
def deploy() -> None:
    """Deploy the Crew CLI group."""

@deploy.command(name="create")                            # :577 crewai deploy create
@click.option("-y", "--yes", is_flag=True, help="Skip the confirmation prompt")
@click.option("--skip-validate", is_flag=True, help="Skip the pre-deploy validation checks.")
def deploy_create(...):
    ...   # 打包 + 调 CrewAI AMP 云端 API 部署

CLI 从 crewai.cli 搬到了独立包 crewai_cli，老导入靠一个 import shim 兜住（crewai/cli/__init__.py）：

# crewai/src/crewai/cli/__init__.py
"""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
the corresponding ``crewai_cli.X`` module so downstream code keeps working."""

_PREFIX = "crewai.cli"; _TARGET = "crewai_cli"
warnings.warn("crewai.cli is deprecated; import from crewai_cli instead.", DeprecationWarning)

class _ShimFinder(importlib.abc.MetaPathFinder):
    def find_spec(self, fullname, path, target=None):
        if fullname != _PREFIX and not fullname.startswith(_PREFIX + "."):
            return None
        mapped = _TARGET + fullname[len(_PREFIX):]     # crewai.cli.X → crewai_cli.X
        module = importlib.import_module(mapped)
        ...   # 造一个 spec 指向已导入的 crewai_cli 子模块

_finder = _ShimFinder()
if _finder not in sys.meta_path:
    sys.meta_path.insert(0, _finder)                   # 装进 import 系统的查找链