用途:当用户想切换到另一个项目、打开其他代码库,或把当前对话移到不同的工作区根目录时使用本技能。
主要能力:Cursor 内置名为 cursor-app-control 的 MCP 服务器,其中 move_agent_to_root 工具可更改智能体的活动工作区目录,从而在对话中途切换项目,无需新开窗口。切换后可见工作区、文件树以及后续命令的默认工作目录都会更新。
使用方式:先确定目标项目,若用户只说“切换到 my-app”,可在常见位置搜索,如 ~/Documents/development/、~/projects/、~/code/、~/repos/,可用 ls ~/Documents/development/ 列出目录;含义不明时向用户确认。随后调用 MCP 工具 move_agent_to_root,参数为 { "rootPath": "/Users/<username>/Documents/development/<project-name>" }。切换后应简要说明所见内容:读取 package.json、README.md 等了解技术栈,运行 git status 查看分支与状态,并列出顶层目录结构。若要新建项目并切换,先调用 create_project 创建目录并初始化 git 仓库,再调用 move_agent_to_root 切入,然后开始搭建。
适用场景:在 Cursor 对话中跨项目切换、打开其他代码库、把会话迁移到新工作区根目录。
限制:仅在 cursor-app-control MCP 服务器启用时可用;切换发生在当前对话内,不会打开新窗口;后续工具调用的所有文件路径都相对于新根目录解析;可用同样方式切回原项目。