devspace README

The project's README from github.com/Waishnav/devspace. As one markdown file: README.md.

DevSpace logo

DevSpace

Bring a Codex-style coding workflow to ChatGPT.

npm CI License

DevSpace connected to ChatGPT

Give ChatGPT a secure connection to your own machine and Turn ChatGPT into Codex

DevSpace is a self-hosted MCP server that lets ChatGPT read, edit, search, and run code in your real local projects — your files, your tools, your terminal — without uploading anything to a third party. You run it on your machine, expose it through a tunnel you control, and approve the connection with a password only you have.

The same /mcp endpoint serves the 2026-07-28 per-request protocol and automatically supports older 2025-era clients through stateless compatibility handling. There is no protocol mode to configure.

Sponsors and Special Thanks

DevSpace is open to new sponsors. Get in touch to become one.

Installation

DevSpace requires Node >=22.19 <27.

Install the DevSpace CLI:

npm install -g @waishnav/devspace

Then initialize DevSpace:

devspace init

Or run it without a global install:

npx @waishnav/devspace init

During setup, DevSpace asks for:

If you select ChatGPT, setup also asks which local project folders it may open and for your public HTTPS base URL from Cloudflare Tunnel, ngrok, Pinggy, Tailscale Funnel, or another reverse proxy. A Coding Agents-only setup asks neither question: local commands use the current Git project, or the current directory outside a repository.

Use the public origin without /mcp during setup:

https://your-tunnel-host.example.com

You will configure your MCP client with the public /mcp URL after setup. Run devspace serve when using ChatGPT. For Coding Agents, setup prints a skills command and lets the Skills CLI handle installation.

When the client connects, DevSpace opens an Owner password approval page. Enter the Owner password printed by devspace init. It is also stored in:

~/.devspace/auth.json

Keep that password private.

Connect Your MCP Client

The default local endpoint is:

http://127.0.0.1:7676/mcp

Most users should connect through a public HTTPS tunnel:

https://your-tunnel-host.example.com/mcp

[!NOTE] Using DevSpace as an MCP connector isn't against OpenAI's Usage Policies — it's a standard custom App/connector setup, and writing or running code isn't a restricted use case. But your account is governed by your usage, not by DevSpace. Don't point it at anything that would violate your provider's terms. Used normally, you're fine. (Based on OpenAI's Usage Policies and Service Terms as of June 2026.)

What ChatGPT Can Do

Once connected, ChatGPT can open one of your approved project folders as a workspace. From there, it can inspect the repo, make scoped edits, run commands, and show you what changed.

DevSpace gives ChatGPT tools to:

Mental Model

DevSpace is remote access to selected local folders.

You decide which roots are allowed. The MCP client still has powerful local capabilities inside an opened workspace, including shell execution. Treat a connected client like a trusted coding partner with access to your machine.

For a normal ChatGPT coding session:

  1. Start your tunnel.
  2. Run devspace serve.
  3. Connect the MCP client to your public /mcp URL.
  4. Approve the connection with the Owner password.
  5. Ask ChatGPT to open a project inside one of your allowed roots.

Platform Support

DevSpace supports Linux, macOS, and Windows environments with a Bash-compatible shell.

Platform Status Notes
Linux Supported Requires Node, npm, Git, and Bash.
macOS Supported Requires Node, npm, Git, and Bash.
Windows with Git Bash, WSL, MSYS2, or Cygwin Bash Supported Git Bash is the simplest native Windows setup.
Windows PowerShell or cmd.exe only Not supported yet Install Git Bash or use WSL.

Run this to inspect your local setup:

devspace doctor

Documentation

Philosophy

Every piece of software is becoming conversational. Natural language is redefining how we interact with tools, workflows, and systems.

My bet is that ChatGPT becomes the operating system for everything. Once we reach AGI, we will simply talk to ChatGPT, and it will prompt, coordinate, and orchestrate sub-agents that set up the right loops for us.

We are not there yet.

DevSpace is one attempt to fast-forward that future: a way for MCP-capable hosts like ChatGPT and Claude to work directly with local project files through explicit, inspectable tools.

Built by Waishnav

I'm Waishnav. I like building opinionated products and tools, and Artifacts is one example.

This year, I began my journey to build a one-person, multi-agent company capable of generating millions in revenue. If you want to follow the failures, wins, lessons, and everything in between, come hang out with me on X.

More from me

Project About
GitCMS
GitCMS 		Modern CMS and tooling for markdown based content sites — built for agents and humans.

Visual editing, editorial workflow, and ChatGPT/Claude content agents, with every post and page stored as files in your repo. Learn more.

Local Development

For working on DevSpace itself:

Install pnpm 11.25.0, the version pinned in package.json, with npm install --global [email protected], then:

pnpm install --frozen-lockfile
pnpm dev:seed
pnpm dev
pnpm typecheck
pnpm test
pnpm build
pnpm start

dev:seed forks your normal DevSpace config and SQLite state into an ignored checkout-local .devspace-dev/ directory so source builds and migrations do not modify your normal installation. Use pnpm dev:reset to discard that QA state and fork it again. See Development and Manual QA for worktree switching, ChatGPT, and database-migration workflows.

devspace (Waishnav/devspace)

Searching Database…

5.3K ·GitHub
Devspace
Что это такое?DevSpace — это MCP-сервер, который вы размещаете у себя. Он позволяет ChatGPT (или другим MCP-совместимым клиентам, например Claude) читать, редактировать, искать и запускать код в ваших реальных локальных проектах, ничего не загружая стороннему сервису.
Это приложение, которое я открываю, или сервер, который я запускаю на своём компьютере?Это сервер, который вы запускаете сами на своём компьютере и открываете наружу через туннель, которым управляете. ИИ-клиент подключается к нему по протоколу MCP, а не по размещённому веб-сервису или настольному приложению с графическим интерфейсом.
Как подключить ChatGPT к моему компьютеру с помощью этого?Запустите туннель, выполните 'devspace serve', затем укажите MCP-клиенту публичный URL с /mcp и подтвердите подключение паролем владельца. После этого можно попросить ChatGPT открыть одобренную папку проекта.
Что нужно установить перед запуском?Нужны Node >=22.19, npm, Git и Bash-совместимая оболочка. В Linux и macOS она есть по умолчанию, а в Windows потребуется Git Bash, WSL, MSYS2 или Cygwin.
Работает ли это на Windows сразу, без дополнительной настройки?Нет. С обычным PowerShell или cmd.exe это пока не поддерживается, поэтому пользователям Windows для рабочей настройки нужен Git Bash или WSL.
Как это не даёт ИИ трогать файлы, которые я не разрешал?Вы сами явно выбираете, какие локальные папки разрешены, а подключение должно быть подтверждено паролем владельца, который знаете только вы.
Что ChatGPT реально может делать после подключения?Он может читать, создавать и редактировать файлы в открытом рабочем пространстве, искать по коду и запускать команды оболочки для тестов, сборок и git. Также он может использовать изолированные Git worktree для параллельных сессий программирования и следовать инструкциям проекта из AGENTS.md и CLAUDE.md.
Это только для ChatGPT?Нет. Поскольку DevSpace открывает стандартную MCP-точку подключения, к тому же /mcp-серверу могут подключаться и другие MCP-совместимые хосты, например Claude, Hermes, Grok Bot и OpenClaw.
Почему автор создал DevSpace, а не стал ждать встроенной функции программирования в ChatGPT?Автор полагает, что ChatGPT станет операционной системой, которая координирует субагентов. Поэтому он создал DevSpace как раннее, открытое и доступное для проверки средство, чтобы MCP-хосты могли напрямую работать с файлами локальных проектов.
What are similar projects?ruflo, openrig, deer-flow, webcodex, headroom, pstack-claude, wigolo, operator-memory
Which topics is it in?pi-coding-agent, harness, chatgpt, model-context-protocol, agent-orchestration, mcp-server, coding-agent, claude, codex, agent, claude-code, mcp
Creator
Waishnav
Size
5 MB
Stars
5.3K
Updated
CommitSep 18Releasev1.0.8Aug 25
Age
4mo
Commits · 90 Days