Webcodex

WebCodex

[English](README.md) | [简体中文](README.zh-CN.md)

**WebCodex lets ChatGPT, Claude, and other AI agents work directly with code and developer tools on your own machines.**

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.

Quick start

On Linux or macOS, with Node.js 18+ and Git installed:

cd /path/to/your/repository
npx --yes @yyjeqhc/webcodex

When WebCodex reports **WebCodex ready**, keep the terminal open. The **MCP URL** is normally copied to your clipboard; press **Enter** in the terminal to open ChatGPT App settings, or open **Settings -> Apps -> Create** manually. Then:

1. Enable Developer Mode if needed and choose Create.
2. Paste the copied MCP URL (or use the URL printed by WebCodex).
3. Choose Access token / API key (or the equivalent Bearer-token option) and paste the printed Credential.
4. Run Scan Tools.

Developer Mode, custom MCP Apps, and write/modify actions depend on your ChatGPT plan, workspace, and administrator policy. WebCodex cannot enable capabilities the client does not grant.

Try a read-only first request:

Inspect this repository and summarize its structure. Do not make changes.

If ChatGPT does not show a Bearer/access-token option, or tries OAuth discovery and reports **does not implement OAuth**, use:

npx --yes @yyjeqhc/webcodex share --auth query-token

Paste the complete `/mcp?token=...` URL and choose **No authentication**. This fallback requires WebCodex 0.3.9 or later. That URL contains a temporary secret, so do not publish or log it. If WebCodex is installed globally, the equivalent command is `webcodex share --auth query-token`. See the [Quick Start](docs/QUICK_START.md) and [MCP setup guide](docs/MCP.md) for details and other clients.

The default o