Turn ChatGPT or Claude into a Codex / Claude Code-style local coding agent for your Windows machine.
AgentDesk is a Windows-first local MCP server that connects ChatGPT, Claude, or another MCP-capable host to your real development machine. It gives your AI assistant Codex-style / Claude Code-style abilities: open a workspace, read and edit approved project folders, run tests and builds, inspect ports and processes, check proxy settings, automate Edge, and diagnose broken localhost/dev-server problems.
Search keywords: ChatGPT MCP coding agent, Claude MCP server, Claude Code-style local agent, Codex-style coding assistant, Windows AI developer copilot, local MCP workspace, AI agent for GitHub projects, ChatGPT local file editing, Claude local terminal access.
AgentDesk is not an official OpenAI Codex or Anthropic Claude Code product. It is an independent MCP bridge that brings similar local coding-agent workflows to ChatGPT, Claude, and other MCP clients.
中文文档见：README.zh-CN.md。
For a first Windows install, use the beginner guide:
docs/first-clone-windows.md
Shortest path:
git clone https://github.com/lfake2320-collab/agentdesk.git
cd agentdesk
npm install
npm run build
Start-AgentDesk.cmdStart-AgentDesk.cmd opens the first-run setup wizard at:
http://127.0.0.1:7876/
After setup, AgentDesk normally runs at:
Local console: http://127.0.0.1:7875/console
Health check: http://127.0.0.1:7875/healthz
Local MCP: http://127.0.0.1:7875/mcp
To verify a fresh clone before opening the wizard:
.\scripts\verify-first-clone.ps1 -SkipTestsChatGPT web cannot normally reach your computer's 127.0.0.1, so use a public HTTPS tunnel such as Cloudflare Tunnel.
Cloudflare step-by-step guide:
docs/cloudflare-tunnel.md
In ChatGPT's MCP / connector settings, use:
Name: AgentDesk
Server URL: https://your-domain.example.com/mcp
Auth: OAuth
Do not put /mcp into Public Base URL inside the setup wizard. The wizard wants the origin only, for example:
https://agentdesk.example.com
AgentDesk can only access folders listed in allowed roots.
Good:
C:\Users\you\Documents\AgentDesk-Workspaces
D:\Code\one-project
G:\devspace-copt-lab\devspace
Avoid whole drives or home folders:
C:\
D:\
G:\
C:\Users\you
The first-run wizard defaults to the current AgentDesk folder plus:
Documents\AgentDesk-Workspaces
If you deliberately add a drive root, the wizard requires an explicit risk acknowledgement.
| Area | AgentDesk |
|---|---|
| Local MCP workspace | Read, search, edit, write, and run commands in approved roots |
| Windows diagnostics | System summary, proxy status, ports, processes, doctor checks |
| Permission profiles | safe, dev, power, owner |
| Process control | Owner-only, opt-in, exact confirmation phrase required |
| Browser tools | Optional isolated/live Edge automation |
| First-run setup | Browser wizard launched by Start-AgentDesk.cmd |
| Public access | Optional Cloudflare named tunnel scripts |
| Startup | Hidden Windows scheduled tasks |
| Packaging | Release zip script and release checklist |
npm test
npm run typecheck
npm run build
npm run verify:first-clone
npm run release:zipCreate a Windows source release zip:
.\scripts\create-release-zip.ps1 -Version 0.1.0Release checklist:
docs/release-checklist.md
- Windows first clone guide
- Cloudflare Tunnel guide
- Release checklist
- Getting Started
- Configuration Reference
- ChatGPT Setup
- Security
- Changelog
After connecting AgentDesk to ChatGPT, try:
@AgentDesk Open my project workspace and diagnose why localhost:8080 is not responding. Check ports, processes, proxy settings, and project scripts before suggesting a fix.
Expected flow:
1. Open workspace.
2. Inspect package scripts and config.
3. Check listening ports.
4. Map the port to a process.
5. Explain the cause.
6. Ask before any risky action.
AgentDesk is remote access to your development machine. Keep allowed roots narrow, keep the Owner Token private, and expose it only through a tunnel/proxy you trust.
Process termination requires all of these:
DEVSPACE_PERMISSION_PROFILE=owner
DEVSPACE_PROCESS_CONTROL=1
Exact confirmation phrase: KILL <pid>
AgentDesk refuses to terminate its own process or parent process.
Current status: v0.1.0 Windows-first Preview.
This is ready for clone-and-test workflows, but it is still a preview rather than a polished commercial installer.
AgentDesk is based on Waishnav/devspace, an excellent self-hosted MCP workspace server for ChatGPT and Claude.
This fork focuses on Windows-first diagnostics, first-run setup, safer local workflows, personal skills, and plugin-oriented automation.
MIT. See LICENSE.