mcpField
S
switching-projects

switching-projects

github.com/spencerpaulyAgent workflows868382 installsUpdated 13w ago
Repository

About switching-projects

A Cursor skill for moving an ongoing agent conversation to another project workspace. It guides project discovery, workspace switching, and initial orientation, with optional instructions for creating a new project.

Key features

  1. 01Find a project in common directories
  2. 02Switch workspace with move_agent_to_root
  3. 03Inspect files and Git status after switching
  4. 04Create and enter a new project

Use cases

  1. 01Continue a conversation in another codebase
  2. 02Locate and open a requested project
  3. 03Start a new project and switch into it

MCP support

Uses Cursor's built-in `cursor-app-control` MCP server and its `move_agent_to_root` tool to change the active workspace. Creating a new project also relies on a `create_project` call.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill switching-projects

After installing, type/switching-projectsin Claude Code to confirm it loaded.

Details

From the project README

Switch Project

Use this skill when the user wants to switch to a different project, open another codebase, or move the current conversation to a different workspace root.

How It Works

Cursor has a built-in MCP server called cursor-app-control with a tool called move_agent_to_root that changes the agent's active workspace directory. This lets you switch projects mid-conversation without opening a new window.

Steps

  1. Ask or infer the target project — if the user says "switch to my-app", search for it. Common project locations:

    • ~/Documents/development/
    • ~/projects/
    • ~/code/
    • ~/repos/

    List directories in the likely parent folder to find the project:

    ls ~/Documents/development/

    If ambiguous, ask the user which project they mean.

  2. Switch the workspace — call the cursor-app-control MCP tool:

    Tool: move_agent_to_root
Arguments: { "rootPath": "/Users/<username>/Documents/development/<project-name>" }

    This updates the visible workspace, file tree, and default working directory for all subsequent commands.

  3. Orient in the new project — after switching, briefly describe what you see:

    • Read the project's package.json, README.md, or equivalent to understand the stack.
    • Run git status to show the current branch and state.
    • List the top-level directory structure.

Creating a New Project

If the user wants to start a new project and switch to it:

  1. Call create_project with the desired path — this creates the directory and initializes a git repo.
  2. Call move_agent_to_root to switch into it.
  3. Begin scaffolding.

Notes

  • This only works if the cursor-app-control MCP server is enabled.
  • The switch happens in the current conversation — no new window is opened.
  • All file paths in subsequent tool calls will resolve relative to the new root.
  • You can switch back to the original project the same way.

Comments

Markdown supported