{"slug":"switching-projects","title":"switching-projects","summary":"Switch the current Cursor workspace to a different project directory using the cursor-app-control MCP. Use when the user asks to switch projects, open another repo, jump to a different codebase, or move to a worktree.","platform":"Cursor","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-08-12T22:23:35.330179Z","repo":{"url":"https://github.com/spencerpauly/awesome-cursor-skills","stars":813,"forks":149,"license":"CC0-1.0","updatedAt":"2026-08-02T02:41:53Z"},"bodyHtml":"<hr>\n<h2>name: switching-projects\ndescription: Switch the current Cursor workspace to a different project directory using the cursor-app-control MCP. Use when the user asks to switch projects, open another repo, jump to a different codebase, or move to a worktree.</h2>\n<h1>Switch Project</h1>\n<p>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.</p>\n<h2>How It Works</h2>\n<p>Cursor has a built-in MCP server called <code>cursor-app-control</code> with a tool called <code>move_agent_to_root</code> that changes the agent's active workspace directory. This lets you switch projects mid-conversation without opening a new window.</p>\n<h2>Steps</h2>\n<ol>\n<li><p><strong>Ask or infer the target project</strong> — if the user says \"switch to my-app\", search for it. Common project locations:</p>\n<ul>\n<li><code>~/Documents/development/</code></li>\n<li><code>~/projects/</code></li>\n<li><code>~/code/</code></li>\n<li><code>~/repos/</code></li>\n</ul>\n<p>List directories in the likely parent folder to find the project:</p>\n<pre><code>ls ~/Documents/development/\n</code></pre>\n<p>If ambiguous, ask the user which project they mean.</p>\n</li>\n<li><p><strong>Switch the workspace</strong> — call the <code>cursor-app-control</code> MCP tool:</p>\n<pre><code>Tool: move_agent_to_root\nArguments: { \"rootPath\": \"/Users/&lt;username&gt;/Documents/development/&lt;project-name&gt;\" }\n</code></pre>\n<p>This updates the visible workspace, file tree, and default working directory for all subsequent commands.</p>\n</li>\n<li><p><strong>Orient in the new project</strong> — after switching, briefly describe what you see:</p>\n<ul>\n<li>Read the project's <code>package.json</code>, <code>README.md</code>, or equivalent to understand the stack.</li>\n<li>Run <code>git status</code> to show the current branch and state.</li>\n<li>List the top-level directory structure.</li>\n</ul>\n</li>\n</ol>\n<h2>Creating a New Project</h2>\n<p>If the user wants to start a new project and switch to it:</p>\n<ol>\n<li>Call <code>create_project</code> with the desired path — this creates the directory and initializes a git repo.</li>\n<li>Call <code>move_agent_to_root</code> to switch into it.</li>\n<li>Begin scaffolding.</li>\n</ol>\n<h2>Notes</h2>\n<ul>\n<li>This only works if the <code>cursor-app-control</code> MCP server is enabled.</li>\n<li>The switch happens in the current conversation — no new window is opened.</li>\n<li>All file paths in subsequent tool calls will resolve relative to the new root.</li>\n<li>You can switch back to the original project the same way.</li>\n</ul>\n","files":[{"path":"SKILL.md","sizeBytes":2237,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-08-12T22:24:57.818807Z","sha256":"E284E5F19320F964C73BBED579F223A1FFC4AEDE6A3A182FB04270C4E8204984","sizeBytes":1121},"review":null,"source":{"repositoryUrl":"https://github.com/spencerpauly/awesome-cursor-skills","path":"resources/switching-projects","license":"CC0-1.0","commit":"99cd2655788456cc1c685944dcf8c2de82c1ded4","subtreeSha":"C5BDF360C310F2C22E69410B41A8173EC5263F3C89C97670139EE95D97EB58E7","lastSyncedAt":"2026-09-25T06:49:08.872487Z"},"reviewedAt":"2026-08-12T22:27:21.873032Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/spencerpauly/awesome-cursor-skills/tree/main/resources/switching-projects"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install spencerpauly-awesome-cursor-skills@llmmart"},{"target":"git","command":"git clone https://github.com/spencerpauly/awesome-cursor-skills.git"}]}