About this project

DevSpace is a self-hosted MCP (Model Context Protocol) server that bridges AI assistants like ChatGPT and Claude with your local development environment. It lets AI clients read, write, edit, and search files in approved project folders, run shell commands for tests and builds, and use isolated Git worktrees for parallel coding sessions—all without uploading code to a third party. The project is built with Node.js (requires >=22.19 <27) and published on npm as @waishnav/devspace. Installation is straightforward: run `npm install -g @waishnav/devspace` followed by `devspace init`, which walks you through choosing your target (ChatGPT, coding agents, or both), selecting subagents, and configuring allowed project roots and a public HTTPS tunnel URL (Cloudflare Tunnel, ngrok, Pinggy, Tailscale Funnel, or similar). Once connected, the MCP client gains tools to inspect repositories, make scoped edits, execute shell commands, discover local agent skills, and follow project instructions from AGENTS.md and CLAUDE.md files. The server exposes a single /mcp endpoint that supports both the 2026-07-28 per-request protocol and older 2025-era clients through stateless compatibility handling. Security is handled through an Owner password approval page that appears when a client connects. The password is printed during init and stored in ~/.devspace/auth.json. Users are advised to treat a connected client as a trusted coding partner with access to their machine. Platform support covers Linux, macOS, and Windows with a Bash-compatible shell (Git Bash, WSL, MSYS2, or Cygwin). A `devspace doctor` command helps inspect local setup. The project includes documentation for setup, ChatGPT coding workflows, configuration, security model, and troubleshooting.