[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-3220":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":10,"pushedAt":10,"updatedAt":25,"readmeContent":26,"aiSummary":27,"trendingCount":15,"starSnapshotCount":15,"syncStatus":28,"lastSyncTime":29,"discoverSource":30},3220,"codex-web","0xcaff\u002Fcodex-web","0xcaff","a browser frontend for codex desktop, running on a machine you control.","",null,"TypeScript",145,14,4,0,7,13,34,21,3.53,false,"main",true,[],"2026-06-12 02:00:47","# codex-web\n\na browser frontend for codex desktop, running on a machine you control.\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F0a33cbd8-741c-412c-9e75-46dfe9324596\n\n## motivation\n\nthe agents were never meant to stay trapped in a terminal window for long.\ncodex desktop brought the power of agents to your local computer, where your\nfiles, credentials, and tools already live.\n\ncodex-web brings codex desktop to the browser while keeping the backend on a\nmachine you control (a linux box in the cloud, your home lab, or a desktop \u002F mac\nmini). agents keep running after your laptop closes. you can reconnect from any\ndevice with a browser.\n\nthis project aims to be as thin a wrapper as possible to ensure upstream changes\nto the codex desktop app can be integrated quickly.\n\n## usage\n\n`codex-web` serves the browser client and hosts the desktop-side bridge. by\ndefault, it listens on `127.0.0.1:8214`.\n\nit will use `codex` from `PATH` if available, or `CODEX_CLI_PATH` if you set\nit.\n\nrun it with `npx`:\n\n```bash\nnpx --yes github:0xcaff\u002Fcodex-web\n```\n\nor with nix:\n\n```bash\nnix run github:0xcaff\u002Fcodex-web\n```\n\nthen open \u003Chttp:\u002F\u002F127.0.0.1:8214> in a browser.\n\n### sign in\n\nensure the codex cli on the host machine is signed in before starting the\nserver.\n\n```bash\ncodex login --device-auth\n```\n\n### proxying to app-server (advanced usage)\n\nit’s often useful to run the app server separately, so a crash or restart of\ncodex-web doesn’t interrupt the codex process executing commands.\n\nit's possible to hook codex-web up to an already-running app server using the\n`codex_remote_proxy` script.\n\nstart a long-lived app server somewhere:\n\n```bash\ncodex app-server --listen unix:\u002F\u002F\u002Ftmp\u002Fcodex-app-server.sock\n```\n\nthen run `codex-web` with the proxy helper:\n\n```bash\nnix shell github:0xcaff\u002Fcodex-web github:0xcaff\u002Fcodex-web#codex_remote_proxy -c bash -lc '\n  export CODEX_UNIX_SOCKET=\u002Ftmp\u002Fcodex-app-server.sock\n  export CODEX_CLI_PATH=\"$(command -v codex_remote_proxy)\"\n  codex-web\n'\n```\n\n## security\n\nrun `codex-web` only on trusted networks. treat anyone who can reach the\n`codex-web` server as someone who can operate codex on the host machine as the\nsame user running the server.\n\nif you need authn or authz, implement it outside of `codex-web`: proxy it through\nwireguard, tailscale, or an ssh tunnel and put an authentication gateway or\nreverse proxy in front.\n\nsomeone with access to the web ui may be able to:\n\n- run commands on the host, limited only by the permissions of the `codex-web`\n  server process.\n- read or modify files, environment variables, credentials, ssh keys, and other\n  local resources that are accessible to that process.\n- use the codex \u002F chatgpt account already signed in on the host. this may\n  consume usage quota or billing credits, and may expose account metadata shown\n  by the app or cli, such as name or email address.\n\n## features\n\n- hostable on macOS, Linux (and anything codex cli + node will run on)\n- reachable from the browser\n- thin wrapper, so updates should land fast\n- working today:\n  - subagents\n  - inline images\n  - editor sidepanel\n  - transcription\n\n## roadmap\n\nsome parts of the desktop experience are not wired up yet:\n\n- browser panel support, likely rebuilt around iframes\n- computer use on linux, which could become a very powerful feature\n- terminal support\n- git worker integration\n- whatever else people find and file issues for\n\n## issues welcome\n\nif something is broken, missing, or rough around the edges, please file an\nissue.\n\nusing `codex-web` in an interesting way? post about it on x and tag me\n[@0xcaff](https:\u002F\u002Fx.com\u002F0xcaff).\n\nusing this at a company and need something more tailored? email me and we can\ntalk.\n\n## alternatives\n\n* [davej\u002Fpocodex](https:\u002F\u002Fgithub.com\u002Fdavej\u002Fpocodex) i used this until the wheels fell off. i needed subagents\n  and an inline image viewer. this didn't have them and was having a hard time\n  keeping up with upstream codex updates.\n* the native codex remote feature (behind a feature flag) is great for\n  connecting to remote codex hosts over ssh to manage long running tasks but\n  this only works if you have codex desktop on your client device. this means it\n  doesn't work on mobile.\n* upcoming first party mobile app from openai. `codex-web` exists and works\n  today. i can't wait for the mobile app but judging by the other openai mobile\n  apps, i'm a little bit skeptical about the quality of the mobile experience.\n  time will tell.\n","codex-web 是一个基于浏览器的前端界面，用于控制运行在你所管理的机器上的 codex 桌面应用。该项目使用 TypeScript 开发，主要功能是通过浏览器访问 codex 桔面端，同时保持后端运行在用户可控的设备上（如云中的 Linux 服务器、家庭实验室或桌面计算机）。这使得即使关闭笔记本电脑后，agents 仍可继续运行，并且可以从任何具有浏览器的设备重新连接。codex-web 设计为尽可能薄的一层封装，以快速集成上游对 codex 桌面应用程序所做的更改。它适用于需要远程访问和控制 codex 功能的场景，尤其是在安全性得到适当保障的情况下。",2,"2026-06-11 02:52:54","CREATED_QUERY"]