webcodex README

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

English · 简体中文

WebCodex

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

MCP protocol Node.js 18 or newer Apache 2.0 license

Ask your assistant to inspect a repository, modify code, run tests, use Git, or investigate a failure. Your repository stays on the machine where it already lives; you do not need to move the project into a hosted workspace just to use an AI coding agent.

WebCodex | GitHub Trending

Start using WebCodex

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:

This branch 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 branch 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 temporary one-repository trials, advanced self-hosting, npm/runtime archives, Docker, or historical release artifacts, see Deployment.

What can it do?

Why WebCodex?

How it works

AI client
   |
   | MCP / HTTPS
   v
WebCodex
   |
   v
your machine
   |
   +-- repository
   +-- Git
   +-- compilers / tests / developer tools

For the internal Server/Runner architecture, protocol surfaces, and authority boundaries, see Architecture, MCP, and Authentication.

Star History

This chart tracks the upstream yyjeqhc/webcodex repository.

Star history of yyjeqhc/webcodex

Platform packages

The unified installer targets Windows NSIS, macOS, and Debian 12 / Ubuntu 22.04+ .deb on x64 and arm64. The branch defines the build pipeline; the six installer variants still require native build and installation acceptance before release. See Unified installation and the validation checklist. Existing release artifacts and npm/Docker deployment paths remain documented as advanced historical/current compatibility references in Deployment.

Documentation

Security

WebCodex can read and modify files and execute commands inside configured project boundaries. Use version control, keep credentials out of prompts/logs/Git, and register only project roots the assistant should access. Tool results, including requested file excerpts, may be returned to the AI client. Read SECURITY.md for the complete model.

Build from source

If a release has a problem, you do not need to wait for a maintainer to produce a new build. Reproducing the issue on current main, testing a focused fix locally, and submitting the result as a pull request are all welcome.

For CLI / Server / Runner development, install Git and the stable Rust toolchain through rustup, then build the normal dogfood profile:

cargo build --locked --profile dogfood --workspace --bins

The binaries are written under target/dogfood/. For Desktop/frontend work, also install Node.js 22 + npm and the native platform toolchain. Windows Desktop development needs an MSVC/Windows SDK environment; macOS development needs Xcode Command Line Tools. The complete prerequisites and source-build workflow are in the Desktop development guide.

For local Desktop installer testing, use the repository helpers rather than a raw Tauri bundle command:

# Windows: clean committed source
.\scripts\build_desktop_windows_local.ps1

# Windows: explicitly package uncommitted local work as dirty dogfood
.\scripts\build_desktop_windows_local.ps1 -AllowDirty

# macOS
bash scripts/build_desktop_macos_local.sh

These are development/dogfood builds, not public release artifacts.

Contributing

Issues and focused pull requests are welcome. Maintainer response time may vary, so users who can reproduce a problem on current main are especially encouraged to investigate it, build and test a fix locally, and submit a PR rather than waiting for the fix to be implemented upstream. WebCodex itself, Codex, ChatGPT, Claude, or other coding agents may be used to help inspect, edit, and validate the repository.

For what to include in a bug report, the self-service fix workflow, validation expectations, and pull request guidance, see CONTRIBUTING.md.

Support WebCodex

WebCodex is developed in the open. If you want to support long-term maintenance, testing, release infrastructure, or cross-platform work, see Sponsorship and project support. We prefer transparent project-level support and infrastructure partnerships that stay separate from normal product use.

Acknowledgements

Thanks to the LINUX DO community for its welcoming space for technical discussion and support for open-source sharing.

License

Licensed under the Apache License, Version 2.0. See LICENSE.

Desktop Shell and Runtime upgrades

Desktop can keep its existing shell while using a separately selected compatible Runtime folder. Build revisions and package versions are diagnostic identity, not compatibility gates. See Desktop Runtime compatibility for custom builds, safe switching/rollback, diagnostics, tracing and update notifications.

webcodex (yyjeqhc/webcodex)

Searching Database…

2.3K ·GitHub
Webcodex
Что это?WebCodex позволяет облачным ИИ-агентам вроде ChatGPT и Claude и другим MCP-клиентам работать в реальной среде разработки, которая остаётся на вашей машине, вместо копирования репозитория в хостед-воркспейс.
Это одно приложение или несколько частей, которые нужно запускать вместе?Это платформа из четырёх компонентов: Desktop, CLI, Server и Runner; единый установщик упаковывает их вместе.
Как запустить WebCodex?Для одной машины установите WebCodex, откройте Desktop и следуйте руководству Unified installation guide. Для нескольких машин установите тот же пакет на хост Server и на каждую машину, где лежат репозитории.
Официальные установщики уже готовы к использованию?Нет — варианты установщиков Windows NSIS, macOS и .deb для Debian/Ubuntu ещё требуют нативных сборок и приёмочных испытаний установки перед релизом, а кроссплатформенное поведение пока не гарантировано.
Какие операционные системы поддерживает WebCodex?Единый установщик нацелен на Windows (NSIS), macOS и Debian 12 / Ubuntu 22.04+ (.deb), для x64 и arm64.
Мой код или репозиторий покидают мою машину?Нет, репозиторий остаётся на машине, где он уже находится; однако результаты инструментов, включая запрошенные фрагменты файлов, могут возвращаться подключённому ИИ-клиенту.
Что такое MCP и какие ИИ-клиенты могут через него подключаться?MCP (Model Context Protocol) — протокол, который предоставляет WebCodex, чтобы ChatGPT, Claude и другие MCP-клиенты могли подключаться к вашим репозиториям, Git-checkout и локальным инструментам.
Можно попробовать на одном репозитории без полной настройки?Да, путь Quick Trial позволяет временно поделиться одним репозиторием с ассистентом через сессию в одну команду, без развёртывания постоянного Server.
Как взаимодействуют Server и Runner?Server координирует сессии, а Runner выполняет работу на машине, где фактически находится репозиторий; это разделение, его протокол и границы полномочий описаны в руководствах Architecture и MCP.
Почему WebCodex, а не хостед-воркспейс для кодинга с ИИ?Он оставляет код, историю Git, компиляторы и инструменты на вашей машине, не загружая их в чат-сервис, и делает долгие задачи наблюдаемыми за пределами одного хода модели.
What are similar projects?ruflo, openpencil, golutra, mixdog, gpt4free, brigade, copperhead, devspace
Which topics is it in?development-environment, grok, gpt, chatgpt, authentication, git, gemini, mcp-server, coding-agent, claude, openai, rust
Creator
yyjeqhc
Size
54.2 MB
Stars
2.3K
Updated
CommitOct 16Releasev0.4.6Oct 03
Age
4mo
Commits · 90 Days