CDX Manager
The right AI coding account, when you need it. CDX Manager keeps your Codex and Claude accounts in separate profiles, shows which ones have quota, and helps you pick the next usable session from your terminal.
When one account hits a limit mid-task, you should not have to guess which login still works or rebuild your context from memory. CDX shows the available accounts and can prepare a transcript-backed handoff to another session.
Get started in a minute
Install with npm (Node.js 18+ and Python 3.9+):
npm install -g cdx-manager
cdx add codex work
cdx add claude personal
cdx status
cdx next
cdx work
cdx next recommends a session and prints the launch command; cdx work opens your isolated work profile. CDX also supports Antigravity and local Ollama sessions. Prefer pipx or uv? See installation and setup.
What you can do
| Need | CDX command | Detail |
|---|---|---|
| See quota and choose an account | cdx status, cdx next |
Quota-aware routing |
| Keep logins and settings separate | cdx add, cdx <name>, cdx set |
Isolated sessions |
| Continue work in another session | cdx handoff source target |
Context handoff |
| Run a prompt from a script | cdx run --prompt "..." --json |
Headless automation |
| Inspect usage or get an alert | cdx stats, cdx ready |
Maintenance and notifications |
CDX checks authentication before interactive launches. Handoff keeps the source transcript in place and asks the receiving agent to verify the conversation and workspace before acting. No account switch or prompt submission happens just because you run cdx next.
Documentation
- Installation and first steps — prerequisites, npm/pipx/uv, Windows, configuration.
- Features and handoff — routing, isolated accounts, automation, recovery.
- Sessions and notifications — alerts, launch settings, history.
- Command and JSON reference — commands, selection, usage fields, programmatic contracts.
- Operations — backup, disk cleanup, Windows notes, troubleshooting, release procedure.
- Technical overview — isolation, status sources, project and data layout.
- Tray companion testing — local development loops.
Contributions are welcome; see CONTRIBUTING.md. CDX Manager is MIT licensed.
1 maintainer
Metadata
1 maintainer
Release files for cdx-manager 0.21.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cdx_manager-0.21.1.tar.gz | 401.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cdx_manager-0.21.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 673.6 kB
Release files / cdx_manager-0.21.1.tar.gz
| Download URL | cdx_manager-0.21.1.tar.gz |
|---|---|
| Size | 401.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
77fb7a4d097543f3ff7aefac75ab4faeeb1509b2c2aa193e730b35c1039b1554
|
|
BLAKE2b-256 checksum How to use checksums |
716f432869859fddc12ea5cf36528d5bc46e2f0a6923082d0cd2b5ea628b045b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.17
|
Release files / cdx_manager-0.21.1-py3-none-any.whl
| Download URL | cdx_manager-0.21.1-py3-none-any.whl |
|---|---|
| Size | 271.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d9069f78b0c39270511c4e834689989b8257fb5bff00b381e146a7b47de79a76
|
|
BLAKE2b-256 checksum How to use checksums |
7c414f6036e1c07828fbe5f930315c5717dd7780bddbeab2d512464382758d74
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.17
|
