yyjeqhc / webcodex

English · 简体中文 
 WebCodex 
 Give cloud AI agents a real development environment on your own machines. 
 Connect ChatGPT, Claude, and other MCP clients to the repositories, Git checkout, and tools you already use. 
 One computer · Several computers · Documentation · Issues · Contribute · Security 
WebCodex is a self-hosted tool runtime: a Server authenticates requests and routes them to a Runner on the machine that owns the repository. Ask your assistant to inspect a repository, modify code, run tests, use Git, or investigate a failure. You do not need to move the project into a hosted workspace; requested file content and other tool results can still be returned to the AI client.
## Start using WebCodex
For a temporary one-repository trial, start with Quick Trial and `webcodex share`. For a persistent setup, the unified installer workflow below is under development; see the validation status before choosing an artifact. Once a validated installer is available, choose the setup that matches where your code lives:
- **One computer:** install WebCodex on your personal workstation, open Desktop, and follow Unified installation. This setup includes Desktop, CLI, Server, and Runner in one platform package.
- **Several computers:** install the same package on the machine that will host the WebCodex Server and on each machine that owns repositories. Follow Unified installation and Deployment validation.
The build pipeline defines unified Windows NSIS, macOS package, and Debian 12 / Ubuntu 22.04+ `.deb` installer targets for x64 and arm64. The six installer variants still require native build and installation acceptance before release. Real-machine installation, reboot persistence, GUI behavior, and upgrade have not been accepted across all three platforms; this documentation makes no claim of identical cross-platform behavior. Published files are listed in GitHub Releases. The `download/` directory contains static page source only; the download-page workflow builds a Release-manifest-based GitHub Actions artifact after publication, but does not host or deploy a page. For a source preview, check out the exact feature or release revision you intend to evaluate and follow Desktop development.
For Linux machines that join an existing Server without Desktop, see Runtime installation and CLI join. For advanced self-hosting, npm/runtime archives, Docker, or historical release artifacts, see Deployment.
## What can it do?
- **Understand and edit code** — read, search, inspect, and make guarded changes inside configured projects.
- **Use the real toolchain** — run commands, tests, formatters, compilers, and project-specific tooling on the machine that owns the repository.
- **Work with Git** — inspect status and diffs while keeping repository operations visible and reviewable.
- **Handle long-running work** — keep jobs observable instead of requiring one model turn to stay open indefinitely.
- **Support human review** — use the Runtime Console, Workflow Session e