用途：把当前 Claude Code 会话迁移到另一个 Cognee 数据集。Cognee 会话不跨两个数据集，因此切换会先同步并退役当前会话，再在所选数据集上开启新会话。
主要能力：列出可写数据集（含 current、datasets、hidden_readonly、filtered 等字段）；指定名称直接切换、未列出的名称会在切换时创建；将当前会话同步进图（sync-session-to-graph.py --strict，失败即中止）；确保目标数据集存在；注册新会话并释放旧连接句柄（register-then-unregister）；重定向本次启动记录，使各 hook、shell 包装、空闲/退出监视与状态行跟随。
使用方式：指定名称时运行 python3 ${CLAUDE_PLUGIN_ROOT}/scripts/switch-dataset.py "$ARGUMENTS" --json；列出选择时运行 python3 ${CLAUDE_PLUGIN_ROOT}/scripts/switch-dataset.py --list --json，再用 AskUserQuestion（单选）展示数据集名称，当前项标 “(current)”，每次最多四选项，超过则前三加 “More…” 分页，也可输入名称。确认后运行 python3 ${CLAUDE_PLUGIN_ROOT}/scripts/switch-dataset.py "<chosen name>" --json。
结果与错误：成功返回 switched 为 true 及 dataset、session_id、previous；已在该数据集则 switched 为 false、reason 为 already_active。失败码：2 启动记录未找到（插件未初始化会话，可运行 cognee-doctor.sh，多会话共享目录时加 --session-key），3 当前会话同步失败（未作变更，仅在用户明确接受未同步条目改在会话结束时重试时才用 --force），4 注册新会话失败（检查连接），5 数据集不可写（改从 --list 选择）。
限制：仅查看其他数据集无需切换，可用 cognee-search.sh 单次图搜索。COGNEE_PLUGIN_DATASET 只在启动时设定数据集，切换会覆盖它并在 --resume 后仍生效；召回范围限于当前数据集，切换后旧数据集上下文不再注入。具体平台、收费与价格资料暂未提供。