switching-projects

Switch the active Cursor workspace to another project directory via the cursor-app-control MCP move_agent_to_root action.

672|104|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill switching-projects
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: switching-projects
Source: https://github.com/spencerpauly/awesome-cursor-skills/tree/main/resources/switching-projects
Command: npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill switching-projects

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of moving an active Cursor conversation to a different codebase, letting you continue work in the right workspace without restarting the session.

Core Features & Use Cases

  • Workspace Switching: Move the agent to a new project root using Cursor's app-control MCP tool.
  • Project Handoffs: Jump between repositories, worktrees, or sibling apps while keeping the same conversation context.
  • Use Case: A developer asks to inspect a different repo or continue in a worktree, and the Skill reorients Cursor in the target directory before analysis begins.

Quick Start

Ask the agent to switch the workspace to the project directory you want to work in.

Frequently Asked Questions about switching-projects

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I switch Cursor to a different project workspace without losing my conversation context?

To switch Cursor workspaces without losing context, you can use a project switching Skill to reorient the active agent into a new project directory. This moves the workspace root without requiring you to open a new window or restart the session.

Can I move an active Cursor conversation into a git worktree?

Yes, you can move an active Cursor conversation into a git worktree by switching the workspace root. The Skill updates the agent's command context to operate within the target worktree directory, allowing seamless codebase transitions.

What is the best way to jump between repositories during an ongoing Cursor agent session?

Jumping between repositories during an ongoing session is best handled by reorienting the agent's root directory. The Skill uses the cursor-app-control MCP to apply the new project path, allowing you to continue work across sibling apps in the same window.

Does switching Cursor projects require opening a new window?

No, switching Cursor projects does not require opening a new window. This Skill applies a new workspace root to the existing session, keeping your conversation history intact while updating the directory context for subsequent commands.

Do I need the cursor-app-control MCP to switch workspaces mid-conversation?

Yes, you need the cursor-app-control MCP installed to switch workspaces mid-conversation. The Skill relies on the move_agent_to_root action from this MCP to update the workspace root and apply the new project directory context.

Why does my Cursor agent still operate in the old directory after a project handoff?

If your Cursor agent still operates in the old directory after a project handoff, the workspace root was not updated. You must explicitly switch the agent's root directory to the new project path so subsequent commands execute in the correct codebase.