Skip to content
Setup guide

Getting Started
with DetachDev

Four steps from zero to running Claude Code® sessions from any device, any AI client, anywhere.

1

Register your device

Log in to the dashboard and register the machine you want to run Claude Code® sessions on. This generates a unique device token and your personal MCP endpoint URL.

  1. Go to dashboard.detachdev.io and create your account
  2. Click Add Device
  3. Give your device a name — e.g. dev-01, macbook-pro, aws-dev
  4. Copy the install command shown — you will use it in Step 2
  5. Note your MCP endpoint URL — you will use it in Step 3
💡 You can register multiple machines. Each gets its own device token. Manage them all from one dashboard.
2

Install the client daemon

Run the install command on your dev machine. The daemon installs as a system service, starts on boot, and connects outbound to the platform — no open ports required.

Run on your dev machine curl -fsSL get.detachdev.io/install.sh | sh

The installer sets up the DetachDev daemon as a systemd service on Linux or a launchd agent on macOS. It starts immediately and restarts automatically on reboot. When complete, your device appears as Online in the dashboard within a few seconds.

💡 Your source code never leaves your machine. The daemon relays commands and output only. Read about the security model →
3

Set up your favourite AI assistant

Add your MCP endpoint to whichever AI client you prefer. You only do this once — it then gives you access to all your registered devices and sessions.

Your MCP endpoint (from the dashboard) https://mcp.detachdev.io/u/your-token

Add this once to each AI client you want to use. You do not need to repeat this per device or per session.

Claude.ai

Adding DetachDev to Claude.ai

  1. Open Claude.ai and go to Settings → Integrations
  2. Click Add custom integration
  3. Paste your MCP endpoint URL
  4. Name it DetachDev and click Save
💡 Test with: "Using DetachDev, list my sessions on dev-01."
ChatGPT

Adding DetachDev to ChatGPT

  1. Open ChatGPT and go to Settings → Actions → Add custom action
  2. Paste your MCP endpoint URL into the Schema URL field — ChatGPT fetches the manifest automatically
  3. Name the action DetachDev and save
💡 Requires ChatGPT Plus or above. Test with: "Using DetachDev, list sessions on my device."
VS Code

Adding DetachDev to VS Code (Copilot)

  1. Press Cmd/Ctrl + Shift + P and run GitHub Copilot: Add MCP Server
  2. Select HTTP (Server-Sent Events)
  3. Paste your MCP endpoint URL and name it DetachDev
💡 Requires GitHub Copilot. Use in Copilot Chat: "List my DetachDev sessions."
4

First usage examples

Your device is connected and your AI client is set up. Here is what to try first — and what DetachDev is actually built for.

List your sessions
"Using DetachDev, list sessions on my device."
Start a new session
"Start a new session on my-api and ask Claude Code to review the authentication module."
Check progress from your phone
"Show me the latest output from my my-api session."
Approve a permission prompt
"Claude Code is waiting for permission to write files — approve it."
Send a follow-up
"Tell my my-api session to also add rate limiting to the auth endpoints."
Resume after a reboot
"Resume the my-api session and continue from where it stopped."

🌙 Start a long task before bed

"Start a session on my-api and ask Claude Code to refactor the entire database layer to use the repository pattern. Let it run overnight."

Check in the next morning: "Show me what my-api completed overnight."

📱 Check in between meetings

"What sessions are running? Has the frontend build finished?"

Get a status summary across all running sessions without opening a laptop.

✈️ Keep work moving while you travel

"Start a session on data-pipeline and ask Claude Code to write unit tests for all functions in the transform module without coverage."

Kick off from the airport. Approve outputs from the plane.

Quick reference

Common commands. Prefix with "Using DetachDev" if your AI client needs context.

What you want to doWhat to say
List all sessions"List my sessions on [device name]"
List projects"List projects on my device"
Start a new session"Start a new session on [project] and ask it to [task]"
Resume a session"Resume the [session name] session"
Check session output"Show the latest output from [session name]"
Send a prompt"Tell the [session name] session to [instruction]"
Approve a permission"Approve the permission prompt on [session name]"
Stop a session"Stop the [session name] session"
View session history"Show the full history of [session name]"