hub / github.com/ezpzai/cdx

github.com/ezpzai/cdx @v1.0.12

Chat with this repo

repository ↗ · DeepWiki ↗ · release v1.0.12 ↗ · + Follow

603 symbols 1,613 edges 61 files 0 documented · 0%

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

English | 한국어 | 简体中文 | 日本語 | Español

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

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:

brew install cloudflared

Linux:

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

cdx login {profile} // first-time setup
cdx run {profile}
cdx remote // mobile access
cdx usage // check usage

On the first interactive Codex command, cdx asks how sessions should be stored.

global: immediately scans discovered Codex homes and merges their sessions into ~/.cdx/sessions
profile: keeps each profile's CODEX_HOME/sessions separate

Main Commands

Command	Description
`cdx remote [profile] [codex args...] [--mode <safe\\|balanced\\|yolo>] [--tunnel <cloudflare\\|none>] [--no-qr] [--lan]`	Continue a desktop Codex session from a mobile web surface.
`cdx run [profile] [codex args...] [--mode <safe\\|balanced\\|yolo>]`	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 <safe\\|balanced\\|yolo> [--profile <profile>]`	Save a global or profile-level default run mode.
`cdx login <profile>`	Create a new profile or log into an existing one.
`cdx logout <profile>`	Start logout for a profile.
`cdx ls`	Show discovered profiles.
`cdx rm <profile> [--force]`	Remove a profile.
`cdx session [status]`	Show or interactively change session storage mode. Default: global `~/.cdx/sessions`.
`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 <profile>
Same Wi-Fi / LAN: cdx remote <profile> --tunnel none --lan
Local only: cdx remote <profile> --tunnel none

Release history lives on GitHub Releases:

https://github.com/ezpzai/cdx/releases

Extension points exported contracts — how you extend this code

ApiErrorPayload (Interface)

(no doc)

vite.config.ts

DashboardProfile (Interface)

(no doc)

src/data.ts

PanelProps (Interface)

(no doc)

src/components/panels.tsx

ApiErrorShape (Interface)

(no doc)

src/lib/dashboard-client.ts

AuthSession (Interface)

(no doc)

src-cli/lib/remote.ts

DashboardUsageRow (Interface)

(no doc)

src/data.ts

AppShellProps (Interface)

(no doc)

src/components/app-shell.tsx

ApiSuccessShape (Interface)

(no doc)

src/lib/dashboard-client.ts

Core symbols most depended-on inside this repo

loadConfig

called by 24

dist-cli/lib/config.js

sendJson

called by 16

src-cli/lib/remote.ts

sendJson

called by 16

dist-cli/lib/remote.js

listProfiles

called by 15

dist-cli/lib/profiles.js

saveConfig

called by 14

dist-cli/lib/config.js

normalizeProfileId

called by 12

src-cli/lib/config.ts

style

called by 12

src-cli/lib/remote-tunnel.ts

ensureSessionStorageLayout

called by 12

dist-cli/lib/session-storage.js

Shape

Function 547

Interface 50

Class 4

Method 2

Languages

TypeScript100%

Modules by API surface

src-cli/lib/config.ts41 symbols

src-cli/lib/remote.ts39 symbols

dist-cli/lib/config.js37 symbols

src-cli/index.ts36 symbols

dist-cli/index.js36 symbols

dist-cli/lib/remote.js33 symbols

src-cli/lib/codex.ts21 symbols

dist-cli/lib/codex.js18 symbols

src-cli/lib/updater.ts17 symbols

src-cli/lib/run-flow.ts17 symbols

src-cli/lib/remote-tunnel.ts16 symbols

src-cli/lib/actions.ts15 symbols

For agents

$ claude mcp add cdx \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact