AI apps

Switch your desk from an AI app

Say “switch to my PC” to Claude, Codex, Copilot, Cursor or Gemini CLI, and it hands your monitor, keyboard and mouse to that computer. Setting it up takes about a minute.

Two ways in: a skill or MCP

Either way, the AI app runs SwitchDesk on your computer with your words for the other computer, and SwitchDesk works out which one you mean, from its name, an alias you gave it, or a close match. If two computers match, the AI asks you which one. It can also list your computers and show where the desk is, without moving anything.

Where both work, pick one: with both, the AI sees two ways to do the same thing.

A switch takes your keyboard and mouse away. Once it goes through, you are typing on the other computer, so the AI on this one can't hear from you until you switch back.

Nothing goes over the internet: the AI app runs SwitchDesk on this computer, and SwitchDesk talks to your desk directly.

Which AI apps can use it

AI appSkillMCP
Claude Code (terminal, desktop app, editors)Yes, from ~/.claude/skillsYes
Claude desktop app, chatNoYes
Codex (CLI, editor extension, app)Yes, from ~/.agents/skillsYes
GitHub Copilot (CLI and VS Code)Yes, from ~/.agents/skills or ~/.copilot/skillsYes
CursorYes, from ~/.agents/skills or ~/.claude/skillsYes
Gemini CLIYes, from ~/.agents/skills or ~/.gemini/skillsYes
Claude on the web or phone, ChatGPT chatNoNo: they only reach MCP servers on the internet, not programs on your computer.

~ is your home folder: /Users/you on a Mac, C:\Users\you on Windows.

First, install SwitchDesk

Get it from the download page and set up your computers. On a Mac, keep it in Applications.

On Windows, for the skill, the AI app finds SwitchDesk.exe by name, so its folder must be on your PATH. In PowerShell, in the folder where SwitchDesk.exe is:

[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$PWD", "User")

Add the skill

On a Mac, in Terminal. This puts the skill in both folders, so every AI app in the table finds it:

for d in ~/.claude/skills ~/.agents/skills; do mkdir -p "$d/switch-desk" && curl -fsSL https://switch-desk.indiesoftware.com.ar/skill/SKILL.md -o "$d/switch-desk/SKILL.md"; done

On Windows, in PowerShell:

foreach ($d in "$HOME\.claude\skills", "$HOME\.agents\skills") { New-Item -ItemType Directory -Force "$d\switch-desk" | Out-Null; Invoke-WebRequest https://switch-desk.indiesoftware.com.ar/skill/SKILL.md -OutFile "$d\switch-desk\SKILL.md" }

Or download SKILL.md and put it in a folder called switch-desk inside the folder your AI app reads. It's plain text, so you can read it first.

Then start a new session in your AI app and ask it to “switch to my PC”, or whatever you called that computer. In Claude Code, /switch-desk my pc does the same. Claude Code runs the skill's two commands without asking, because the skill allows exactly those; other AI apps ask before they run a command unless you have told them not to.

Add the MCP server

The AI app starts SwitchDesk with --mcp. On a Mac the program is /Applications/SwitchDesk.app/Contents/MacOS/SwitchDesk; on Windows it is SwitchDesk.exe wherever you put it. In the examples below, put your Windows path in place of the Mac one, with each \ doubled inside JSON ("C:\\Tools\\SwitchDesk.exe").

It gives the AI three tools: list_computers, desk_status and switch_to.

Claude desktop app: Settings, Developer, Edit Config opens claude_desktop_config.json. Add this, then quit and reopen the app:

{ "mcpServers": { "switchdesk": { "command": "/Applications/SwitchDesk.app/Contents/MacOS/SwitchDesk", "args": ["--mcp"] } } }

If the file already has an mcpServers section, add the switchdesk part inside it.

Claude Code, in a terminal:

claude mcp add --transport stdio --scope user switchdesk -- /Applications/SwitchDesk.app/Contents/MacOS/SwitchDesk --mcp

Codex, in a terminal (the Codex app and editor extension share its settings):

codex mcp add switchdesk -- /Applications/SwitchDesk.app/Contents/MacOS/SwitchDesk --mcp

Cursor: the same mcpServers section as for the Claude desktop app, in ~/.cursor/mcp.json.

Gemini CLI: the same mcpServers section, in ~/.gemini/settings.json.

VS Code with Copilot: in the Command Palette, MCP: Open User Configuration, then add:

{ "servers": { "switchdesk": { "type": "stdio", "command": "/Applications/SwitchDesk.app/Contents/MacOS/SwitchDesk", "args": ["--mcp"] } } }

Copilot CLI: /mcp add asks for the command and its arguments.

If it doesn't work