ccx for CloudCLI

A CloudCLI tab for ccx, which keeps a Claude Code session and a Codex thread linked so either app can pick up where the other left off.

In the tab you get:

• Usage: how much of Claude's and Codex's 5-hour (or weekly) window is used, and when it resets.
• The open session: whether it's linked to the other app yet, and whether the other side is missing new progress.
• Continue in Claude / Continue in Codex: the first time, imports the session into the other app with its full context and links the two. After that it brings over only the new progress. Then pick the session in CloudCLI's list, or open it in the desktop app.

Requirements

• macOS with ccx 0.0.35 or later: curl -fsSL https://github.com/raw/aaronwong1999/ccx/main/install.sh | sh
• Claude Code and/or the Codex app on the same machine as CloudCLI.

Without ccx, the tab tells you how to install it and does nothing else.

Install

In CloudCLI, open Settings → Plugins, paste https://github.com/AaronWong1999/cloudcli-plugin-ccx and install. CloudCLI builds it with npm run build.

How it works

The backend (src/server.ts) runs the ccx command at ~/.local/bin/ccx (override with CCX_BIN) without a shell:

Request	Runs
GET /status	ccx usage --json
GET /session?id=…	ccx info <id> --json
POST /handoff	ccx to-codex / ccx to-claude <id> --json --no-open

It keeps no state and makes no network requests. ccx itself runs entirely on your Mac; Codex data goes only through Codex's own app-server.

Develop

npm install
npm test

License

MIT