https://github.com/ezpzai/cdx
Use Codex more easily, even from mobile.
https://github.com/ezpzai/cdx
ai cli codex developer-tools mobile productivity remote vibecoding
Last synced: 14 days ago
JSON representation
Use Codex more easily, even from mobile.
- Host: GitHub
- URL: https://github.com/ezpzai/cdx
- Owner: ezpzai
- License: apache-2.0
- Created: 2026-03-09T06:21:20.000Z (20 days ago)
- Default Branch: main
- Last Pushed: 2026-03-11T05:13:47.000Z (18 days ago)
- Last Synced: 2026-03-12T10:48:27.812Z (17 days ago)
- Topics: ai, cli, codex, developer-tools, mobile, productivity, remote, vibecoding
- Language: JavaScript
- Homepage:
- Size: 826 KB
- Stars: 8
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# cdx
**Use Codex more easily, even from mobile.**
## Quick Start
### Requirements
- Node.js 20+
- Codex installed: `npm install -g @openai/codex`
- `cloudflared` required
- Linux and macOS supported
### Install
```bash
npm install -g @ezpzai/cdx
```
### Install Cloudflare Quick Tunnel
`cdx remote` uses Cloudflare Quick Tunnel by default.
* https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/downloads
macOS:
```bash
brew install cloudflared
```
Linux:
```bash
curl -Lo cloudflared https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64
chmod +x cloudflared
sudo mv cloudflared /usr/local/bin/
```
### First Run
```bash
cdx login {profile} // first-time setup
cdx run {profile}
cdx remote // mobile access
cdx usage // check usage
```
## Main Commands
| Command | Description |
| --- | --- |
| `cdx remote [profile] [codex args...] [--mode ] [--tunnel ] [--no-qr] [--lan]` | Continue a desktop Codex session from a mobile web surface. |
| `cdx run [profile] [codex args...] [--mode ]` | Launch Codex with the selected profile's `CODEX_HOME`. |
| `cdx usage [profile] [--json]` | Check auth and quota status for each profile. |
| `cdx mode` | Show the current default run mode. |
| `cdx mode set [--profile ]` | Save a global or profile-level default run mode. |
| `cdx login ` | Create a new profile or log into an existing one. |
| `cdx logout ` | Start logout for a profile. |
| `cdx ls` | Show discovered profiles. |
| `cdx rm [--force]` | Remove a profile. |
| `cdx agents edit --global` | Prepare and open the shared global `AGENTS.md`. |
| `cdx agents status` | Check project and global `AGENTS.md` wiring. |
`cdx remote` uses `Cloudflare Quick Tunnel` as the default external path.
- External link: `cdx remote `
- Same Wi-Fi / LAN: `cdx remote --tunnel none --lan`
- Local only: `cdx remote --tunnel none`