{"id":46935136,"url":"https://github.com/ezpzai/cdx","last_synced_at":"2026-04-02T20:59:00.628Z","repository":{"id":343427167,"uuid":"1176560223","full_name":"ezpzai/cdx","owner":"ezpzai","description":"Use Codex more easily, even from mobile.","archived":false,"fork":false,"pushed_at":"2026-03-11T05:13:47.000Z","size":846,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-03-12T10:48:27.812Z","etag":null,"topics":["ai","cli","codex","developer-tools","mobile","productivity","remote","vibecoding"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ezpzai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-09T06:21:20.000Z","updated_at":"2026-03-12T05:18:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ezpzai/cdx","commit_stats":null,"previous_names":["ezpzai/cdx"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/ezpzai/cdx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezpzai%2Fcdx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezpzai%2Fcdx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezpzai%2Fcdx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezpzai%2Fcdx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ezpzai","download_url":"https://codeload.github.com/ezpzai/cdx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezpzai%2Fcdx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30460818,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T06:34:02.089Z","status":"ssl_error","status_checked_at":"2026-03-13T06:33:49.182Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","cli","codex","developer-tools","mobile","productivity","remote","vibecoding"],"created_at":"2026-03-11T05:16:20.607Z","updated_at":"2026-04-02T20:59:00.618Z","avatar_url":"https://github.com/ezpzai.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"./README.md\"\u003eEnglish\u003c/a\u003e |\n  \u003ca href=\"./locale/README.ko.md\"\u003e한국어\u003c/a\u003e |\n  \u003ca href=\"./locale/README.zh-CN.md\"\u003e简体中文\u003c/a\u003e |\n  \u003ca href=\"./locale/README.ja.md\"\u003e日本語\u003c/a\u003e |\n  \u003ca href=\"./locale/README.es.md\"\u003eEspañol\u003c/a\u003e\n\u003c/div\u003e\n\n# cdx\n\n**Use Codex more easily, even from mobile.**\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./assets/social-preview.png\" alt=\"cdx social preview\" width=\"100%\" /\u003e\n\u003c/div\u003e\n\n## Quick Start\n\n### Requirements\n\n- Node.js 20+\n- Codex installed: `npm install -g @openai/codex`\n- `cloudflared` required\n- Linux and macOS supported\n\n### Install\n\n```bash\nnpm install -g @ezpzai/cdx\n```\n\n### Install Cloudflare Quick Tunnel\n\n`cdx remote` uses Cloudflare Quick Tunnel by default.\n\n* https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/downloads\n\nmacOS:\n\n```bash\nbrew install cloudflared\n```\n\nLinux:\n\n```bash\ncurl -Lo cloudflared https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64\nchmod +x cloudflared\nsudo mv cloudflared /usr/local/bin/\n```\n\n### First Run\n\n```bash\ncdx login {profile} // first-time setup\ncdx run {profile}\ncdx remote // mobile access\ncdx usage // check usage\n```\n\nOn the first interactive Codex command, `cdx` asks how sessions should be stored.\n\n- `global`: immediately scans discovered Codex homes and merges their sessions into `~/.cdx/sessions`\n- `profile`: keeps each profile's `CODEX_HOME/sessions` separate\n\n## Main Commands\n\n| Command | Description |\n| --- | --- |\n| `cdx remote [profile] [codex args...] [--mode \u003csafe\\|balanced\\|yolo\u003e] [--tunnel \u003ccloudflare\\|none\u003e] [--no-qr] [--lan]` | Continue a desktop Codex session from a mobile web surface. |\n| `cdx run [profile] [codex args...] [--mode \u003csafe\\|balanced\\|yolo\u003e]` | Launch Codex with the selected profile's `CODEX_HOME`. |\n| `cdx usage [profile] [--json]` | Check auth and quota status for each profile. |\n| `cdx mode` | Show the current default run mode. |\n| `cdx mode set \u003csafe\\|balanced\\|yolo\u003e [--profile \u003cprofile\u003e]` | Save a global or profile-level default run mode. |\n| `cdx login \u003cprofile\u003e` | Create a new profile or log into an existing one. |\n| `cdx logout \u003cprofile\u003e` | Start logout for a profile. |\n| `cdx ls` | Show discovered profiles. |\n| `cdx rm \u003cprofile\u003e [--force]` | Remove a profile. |\n| `cdx session [status]` | Show or interactively change session storage mode. Default: global `~/.cdx/sessions`. |\n| `cdx agents edit --global` | Prepare and open the shared global `AGENTS.md`. |\n| `cdx agents status` | Check project and global `AGENTS.md` wiring. |\n\n`cdx remote` uses `Cloudflare Quick Tunnel` as the default external path.\n\n- External link: `cdx remote \u003cprofile\u003e`\n- Same Wi-Fi / LAN: `cdx remote \u003cprofile\u003e --tunnel none --lan`\n- Local only: `cdx remote \u003cprofile\u003e --tunnel none`\n\nRelease history lives on GitHub Releases:\n\n- https://github.com/ezpzai/cdx/releases\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezpzai%2Fcdx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fezpzai%2Fcdx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezpzai%2Fcdx/lists"}