https://github.com/pavel-voronin/codex-web-local
A lightweight web interface for Codex that runs on top of the Codex app-server, allowing remote access from any browser
https://github.com/pavel-voronin/codex-web-local
cli codex openai remote web-ui
Last synced: 4 months ago
JSON representation
A lightweight web interface for Codex that runs on top of the Codex app-server, allowing remote access from any browser
- Host: GitHub
- URL: https://github.com/pavel-voronin/codex-web-local
- Owner: pavel-voronin
- License: mit
- Created: 2026-02-16T05:55:37.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-16T06:12:18.000Z (5 months ago)
- Last Synced: 2026-02-20T05:55:11.958Z (5 months ago)
- Topics: cli, codex, openai, remote, web-ui
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/codex-web-local
- Size: 365 KB
- Stars: 6
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# `npx codex-web-local`
A lightweight web interface for [Codex](https://github.com/openai/codex) that replicates the desktop UI and runs on top of the Codex `app-server`. It exposes Codex through a web application, allowing you to access your local Codex instance remotely from any browser.
## Prerequisites
- [Codex CLI](https://github.com/openai/codex) installed and available in your `PATH`
## Installation
```bash
# Run directly with npx (no install required)
npx codex-web-local
# Or install globally
npm install -g codex-web-local
```
## Usage
```
Usage: codex-web-local [options]
Web interface for Codex app-server
Options:
-p, --port port to listen on (default: "3000")
--password set a specific password
--no-password disable password protection
-h, --help display help for command
```
## Examples
```bash
# Start with auto-generated password on default port 3000
codex-web-local
# Start on a custom port
codex-web-local --port 8080
# Start with a specific password
codex-web-local --password my-secret
# Start without password protection (use only on trusted networks)
codex-web-local --no-password
```
When started with password protection (default), the server prints the password to the console. Open the URL in your browser, enter the password, and you're in.
## Contributing
Issues and pull requests are welcome! If you have ideas, suggestions, or found a bug, please open an issue on the [GitHub repository](https://github.com/pavel-voronin/codex-web-local/issues).
## License
[MIT](./LICENSE)