prodex 0.2.102

Safe multi-account auto-rotate for Codex CLI with isolated CODEX_HOME profiles
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

# prodex

Safe multi-account auto-rotate for `codex`.

`prodex` wraps `codex` with isolated profiles, built-in quota checks, and seamless account rotation.

## Why prodex

- auto-rotate to another ready account when the current one is quota-blocked or temporarily unhealthy
- keep each account isolated in its own `CODEX_HOME`
- preserve continuation affinity so ongoing chains stay on the right account
- keep transport behavior close to direct `codex`

## Install

Install from npm:

```bash
npm install -g @christiandoxa/prodex
```

This is usually the lightest option because it does not need a local Rust build.

Or install from [crates.io](https://crates.io/crates/prodex):

```bash
cargo install prodex
```

The npm package version is kept in lockstep with the published crate version.

## Update Tips

Check your installed version first:

```bash
prodex --version
```

The current local binary version in this repo is `0.2.102`, so matching update commands look like this:

```bash
npm install -g @christiandoxa/prodex@0.2.102
cargo install prodex --force --version 0.2.102
```

If you just want the lighter install path, prefer npm over `cargo install` because npm does not need to compile `prodex` locally.

If you want to move from a Cargo-installed binary to npm, uninstall the Cargo binary first and then install the npm package:

```bash
cargo uninstall prodex
npm install -g @christiandoxa/prodex
```

## Quick Start

Import your current `codex` login:

```bash
prodex profile import-current main
```

Or create a profile through `codex login`:

```bash
prodex login
```

If you need device-code auth, pass it through unchanged:

```bash
prodex login --device-auth
```

Check quotas:

```bash
prodex quota --all
prodex info
```

Run `codex` with safe auto-rotate:

```bash
prodex
prodex run
```

Running `prodex` without a subcommand is shorthand for `prodex run`.

Resume a saved Codex session directly:

```bash
prodex run 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
```

Pin a specific profile when needed:

```bash
prodex run --profile second
```

`prodex run exec` also preserves stdin passthrough, so prompt and piped input stay together:

```bash
printf 'context from stdin' | prodex run exec "summarize this"
```

## Core Commands

```bash
prodex
prodex exec "review this repo"
prodex profile list
prodex use --profile main
prodex info
prodex quota --all
prodex quota --all --once
prodex doctor
prodex doctor --runtime
prodex run
prodex run 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
```

## Notes

- one `prodex` profile = one isolated `CODEX_HOME`
- `prodex login` still uses the real `codex login` flow, including `--device-auth`
- `prodex login` without `--profile` first tries to read the ChatGPT account email from `tokens.id_token` in `auth.json`, then falls back to the usage endpoint email when needed
- `prodex` without a subcommand behaves like `prodex run`
- `prodex run <session-id>` forwards to `codex resume <session-id>`
- `prodex info` summarizes profile count, the installed prodex version and update status, running Prodex processes, aggregated quota pool, and a no-reset runway estimate from active runtime logs
- `prodex quota` live-refreshes every 5 seconds by default, and `prodex quota --all` also shows aggregated `5h` and `weekly` pool remaining before the per-profile table
- Prodex-owned screens adapt to terminal width, and live views can also adapt to terminal height

For a slightly longer setup guide, see [QUICKSTART.md](./QUICKSTART.md).