Your Laptop Is the AI Agent's Development Environment
WebCodex lets ChatGPT, Claude, and other cloud agents read, edit, and run tests on code that stays on your own machine.
An open-source Apache 2.0 project turns your laptop into a controlled staging ground for cloud-hosted AI agents, letting them read, edit, and test code through standard protocols while the repository never leaves your machine.

What it does
WebCodex is a self-hosted runtime that connects cloud AI assistants to your local development machine. It exposes your real repositories, Git history, compilers, and test suites to agents like ChatGPT and Claude through a secure local bridge, so the code never leaves your hardware. You can grant temporary access to a single project or set up a durable Server and Runner for ongoing multi-project work.
The interesting bit
Instead of asking you to upload files into a chat context or migrate to a hosted workspace, WebCodex uses the MCP protocol to turn your existing machine into the agent’s native environment. The agent operates inside the same toolchain you already use, while project-boundary restrictions and explicit registration keep it from wandering across your filesystem.
Key highlights
- Supports both ephemeral single-project sessions and persistent multi-project setups through a Server/Runner architecture.
- Ships as a Rust CLI with native Desktop applications for macOS and Windows, plus tunneling integrations for OpenAI Secure Tunnel and Cloudflare.
- Surfaces a Runtime Console and task workflow for human review, letting you cancel, accept, or reject the agent’s work mid-flight.
- Enforces configurable project boundaries so the assistant can only touch directories you explicitly register.
Caveats
- Windows ARM64 support is currently uneven: the Desktop installer is x64-only, and Cloudflare tunnels require a manually provided
cloudflaredbinary. - Because the tool can execute arbitrary commands within registered project roots, misconfigured boundaries or leaked credentials pose genuine operational risk.
Verdict
Developers who want cloud AI agents to work on private or large local codebases without vendor lock-in should look here. If you already live entirely in cloud IDEs or prefer fully managed agent hosting, the self-hosted tunneling and local Server setup will feel like unnecessary plumbing.
Frequently asked
- What is yyjeqhc/webcodex?
- WebCodex lets ChatGPT, Claude, and other cloud agents read, edit, and run tests on code that stays on your own machine.
- Is webcodex open source?
- Yes — yyjeqhc/webcodex is open source, released under the Apache-2.0 license.
- What language is webcodex written in?
- yyjeqhc/webcodex is primarily written in Rust.
- How popular is webcodex?
- yyjeqhc/webcodex has 2.4k stars on GitHub and is currently cooling off.
- Where can I find webcodex?
- yyjeqhc/webcodex is on GitHub at https://github.com/yyjeqhc/webcodex.