[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-96409":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":9,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":17,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":19,"hasPages":19,"topics":9,"createdAt":9,"pushedAt":9,"updatedAt":21,"readmeContent":22,"aiSummary":9,"trendingCount":16,"starSnapshotCount":16,"syncStatus":14,"lastSyncTime":23,"discoverSource":24},96409,"webcodex","yyjeqhc\u002Fwebcodex","yyjeqhc","Give cloud AI agents a real development environment on your own machines.",null,"https:\u002F\u002Fgithub.com\u002Fyyjeqhc\u002Fwebcodex","Rust",1289,160,2,11,0,94,81.02,false,"main","2026-09-21 04:01:30","# WebCodex\n\n[English](README.md) | [简体中文](README.zh-CN.md)\n\n**WebCodex lets ChatGPT, Claude, and other AI agents work directly with code and developer tools on your own machines.**\n\nAsk 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.\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F121867\">\n    \u003Cimg src=\"https:\u002F\u002Ftrendshift.io\u002Fapi\u002Fbadge\u002Frepositories\u002F121867\" alt=\"WebCodex | GitHub Trending\" width=\"250\" height=\"55\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n## Start using WebCodex\n\n### Everyday development: full WebCodex (recommended)\n\nIf you want ChatGPT to keep using your real development environment, start with a **regular Server + Runner**. This is the full development experience: durable access to multiple projects plus project exploration, editing, Git, commands, tests, long-running work, and code navigation. Public HTTPS, Cloudflare Tunnel, and OpenAI Secure MCP Tunnel are only ways for ChatGPT to reach the Server; they do not switch you into a different restricted experience.\n\nFor Windows or macOS, the recommended first path is **WebCodex Desktop + the official OpenAI Secure Tunnel**. Follow the [Desktop installation guide](docs\u002Fdesktop-install.md). For CLI, an existing Server, self-hosting, or advanced setup, use the [Full Setup guide](docs\u002FPERSONAL_SETUP.md).\n\n### Just trying it for a few minutes: temporary share\n\nTo quickly see whether WebCodex fits your workflow, run this inside one repository:\n\n```bash\ncd \u002Fpath\u002Fto\u002Fyour\u002Frepository\nnpx --yes @yyjeqhc\u002Fwebcodex share\n```\n\n`share` starts a temporary, single-project instance of the ordinary WebCodex Adaptive Runtime and prints the ChatGPT connection values. Its temporary Project Credential limits access to that ProjectGrant; the endpoint and credential stop working when the command exits. It is intended for trials and short-lived sharing, not as the default full daily setup. See the [Quick Trial](docs\u002FQUICK_START.md) for the exact steps.\n\n## What can it do?\n\n- **Understand and edit code** — read, search, inspect, and make guarded changes inside configured projects.\n- **Use the real toolchain** — run commands, tests, formatters, compilers, and project-specific tooling on the machine that owns the repository.\n- **Work with Git** — inspect status and diffs while keeping repository operations visible and reviewable.\n- **Handle long-running work** — keep jobs observable instead of requiring one model turn to stay open indefinitely.\n- **Support human review** — use the [Runtime Console](docs\u002Fruntime-console.md), Workflow Session evidence, Jobs, and Git\u002Fdiff review without a separate task\u002Fresult acceptance subsystem.\n\n## Why WebCodex?\n\n- **Your code stays on your machine.** The repository does not need to be copied into the chat service.\n- **The agent gets a real development environment.** It can use the same files, Git checkout, compilers, tests, and tools you already use.\n- **Work survives beyond a single request.** Long-running execution and evidence remain observable through WebCodex.\n- **Start temporary or run it long-term.** Use one-command sharing for a quick session, or connect machines to a self-hosted Server for a durable setup.\n\n## How it works\n\n```text\nAI client\n   |\n   | MCP \u002F HTTPS\n   v\nWebCodex\n   |\n   v\nyour machine\n   |\n   +-- repository\n   +-- Git\n   +-- compilers \u002F tests \u002F developer tools\n```\n\nFor the internal Server\u002FRunner architecture, protocol surfaces, and authority boundaries, see [Architecture](docs\u002FARCHITECTURE.md), [MCP](docs\u002FMCP.md), and [Authentication](docs\u002FAUTH_MODEL.md).\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fimage?repos=yyjeqhc\u002Fwebcodex&type=Date)](https:\u002F\u002Fwww.star-history.com\u002Fyyjeqhc\u002Fwebcodex)\n\n## Platforms\n\n- **Linux x64\u002Farm64** — local `share`, Server, and Runner workflows.\n- **macOS x64\u002Farm64** — Desktop local Server + Runner, OpenAI Secure Tunnel, local `share`, and standalone Runner workflows.\n- **Windows x64** — Desktop local Server + Runner with the official OpenAI Secure Tunnel, plus CLI + Runner, local foreground Server, and explicit `webcodex share --tunnel cloudflare|openai|none`.\n- **Windows arm64** — CLI + Runner, local foreground Server, and `share`; managed OpenAI `tunnel-client` is supported. The pinned Cloudflare release has no official Windows ARM64 artifact, so Cloudflare requires a trusted explicit\u002FPATH `cloudflared`. The Desktop installer is currently Windows x64 only. WebCodex-managed Windows Server services remain unsupported outside Desktop's owned foreground runtime.\n\nWindows and long-lived deployments are covered in [Deployment](docs\u002FDEPLOYMENT.md) and [MCP](docs\u002FMCP.md).\n\n## Existing Servers and advanced setup\n\nIf someone already provides the WebCodex Server and connection credential, use that existing Server and follow the [Full Setup guide](docs\u002FPERSONAL_SETUP.md). For a normal Windows\u002FmacOS personal installation, use the [Desktop guide](docs\u002Fdesktop-install.md). Use [Deployment](docs\u002FDEPLOYMENT.md) only for production hosting, multiple users, systemd\u002FDocker, OAuth, proxies, and private CAs.\n\nThose are follow-up operating concerns, not concepts a first-time user should have to learn before WebCodex works.\n\n## Documentation\n\n- [Desktop installation](docs\u002Fdesktop-install.md) — recommended Windows\u002FmacOS path: Desktop + official OpenAI Secure Tunnel\n- [Using Desktop](docs\u002Fdesktop-guide.md) — projects, connections, activity, and background operation\n- [Full Setup](docs\u002FPERSONAL_SETUP.md) — CLI, existing Server, Linux, and advanced regular Server + Runner setup\n- [Quick Trial](docs\u002FQUICK_START.md) — temporarily try one repository with `share`\n- [MCP](docs\u002FMCP.md) — ChatGPT, Claude, authentication choices, and MCP reference\n- [Deployment](docs\u002FDEPLOYMENT.md) — production, self-hosting, and advanced operations\n- [Troubleshooting](docs\u002FTROUBLESHOOTING.md) — connection and runtime problems\n- [CLI](docs\u002FCLI.md) — command and credential reference\n- [AI-assisted setup](docs\u002FAI_ONBOARDING.md) — have an AI agent help configure WebCodex\n- [Security](SECURITY.md) — security model and operational guidance\n- [Documentation index](docs\u002FINDEX.md) — all user and contributor documentation\n\n## Security\n\nWebCodex can read and modify files and execute commands inside configured project boundaries. Use version control, keep credentials out of prompts\u002Flogs\u002FGit, and register only project roots the assistant should access. Read [SECURITY.md](SECURITY.md) for the complete model.\n\n## Build from source\n\n```bash\ncargo build --release --workspace --bins\nexport PATH=\"$PWD\u002Ftarget\u002Frelease:$PATH\"\n```\n\n## Contributing\n\nContributions are welcome, including contributions created with WebCodex itself or other coding agents. For bug reports, development workflow, and pull request guidance, see [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## Acknowledgements\n\nThanks to the [LINUX DO](https:\u002F\u002Flinux.do\u002F) community for its welcoming space for technical discussion and support for open-source sharing.\n\n## License\n\nLicensed under the Apache License, Version 2.0. See [LICENSE](LICENSE).\n","2026-09-19 02:30:05","trending"]