You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit c4e3496
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: docs-site/src/content/docs/reference/configuration.md
+27-15Lines changed: 27 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -53,6 +53,7 @@ differing backup and rewrites known legacy namespaced selected ids to bare ids.
53
53
|`syncResumeHistory?`|`boolean`|`true`| Reversible Codex App history compatibility mode. opencodex backs up original Codex thread metadata, remaps old OpenAI interactive rows to `opencodex`, and temporarily promotes opencodex-created `exec` rows to an app-visible source. `ocx stop` / `ocx restore` restore backed-up OpenAI rows and eject remaining opencodex user threads to OpenAI so native Codex can resume them after the proxy is removed from `config.toml`. Set `false` to opt out. |
54
54
|`codexAccounts?`|`CodexAccount[]`|`[]`| ChatGPT/Codex pool account metadata managed by the Codex Auth dashboard. Secrets live separately in `codex-accounts.json`. |
55
55
|`codexAccountNamespaces?`|`Record<string,string>`|`{}`| Optional picker namespace to exact Codex account id map. Use `"main"` for the current Codex Desktop/main login. When present, account-qualified native rows replace plain GPT rows in the picker and fail closed instead of switching accounts. Plain model ids remain routable. Namespace keys cannot collide with provider ids. |
56
+
|`codexAccountPickerEnabled?`|`boolean`| inferred | Picker-visibility override. A non-empty namespace map is visible when this is omitted. The dashboard writes `false` to hide account-specific rows without deleting their bindings. |
56
57
|`activeCodexAccountId?`|`string`| — | Pool account used for the next new Codex thread. Existing thread affinities keep their original account. |
57
58
|`autoSwitchThreshold?`|`number`|`80`| Usage percent threshold for new-session auto-switching. The score uses the hottest known 5h, weekly, or 30d quota window. Set `0` to disable quota auto-switching. |
58
59
|`upstreamFailoverThreshold?`|`number`|`3`| Consecutive transient upstream failures before future new sessions fail over to another eligible pool account. Set `0` to disable failure failover. |
@@ -85,34 +86,45 @@ Use `codexAccountNamespaces` when account choice must be visible and intentional
85
86
```json
86
87
{
87
88
"codexAccountNamespaces": {
88
-
"personal": "main",
89
-
"work": "work-account-id"
89
+
"main": "main",
90
+
"side": "added-account-id"
90
91
}
91
92
}
92
93
```
93
94
94
-
The added account id is the `ID` shown by `ocx account list openai`; the namespace is a user-owned
95
-
label. After `ocx sync`, Codex exposes `personal/gpt-*` and `work/gpt-*` copies of every available
95
+
The added account id is the local `ID` shown by `ocx account list openai`; the namespace is a
96
+
user-owned picker prefix. After `ocx sync`, Codex exposes `main/gpt-*` and `side/gpt-*` copies of every available
96
97
supported native model. When a later opencodex update adds support for another native model, the next
97
98
catalog sync gives it the same prefixes without adding the model separately to this map.
98
99
99
-
The dashboard's **Codex Auth** page exposes **Choose account in model picker** as the single opt-in.
100
-
Turning it on creates `personal` for the main/Desktop login and uses each currently added account's
101
-
alias (or id) for the other prefixes. Turning it off removes the account-qualified catalog rows.
102
-
Account ids stay server-side. Prefixes stay stable if an account alias is renamed; accounts added
103
-
later receive a new prefix automatically while the feature remains enabled.
104
-
105
-
When enabled, plain native rows are hidden from the picker and replaced by readable entries such as
106
-
`Personal / 5.6 Sol` and `Work / 5.6 Sol`. Plain model ids are not removed or rerouted: saved threads
107
-
and configuration that use `gpt-*` continue to follow Pool/Direct behavior. Because Codex exposes a
108
-
flat picker rather than section metadata, the account-specific pairs stay together ahead of ordinary
109
-
routed rows; explicitly featured subagent models retain their higher priority.
100
+
The dashboard's **Codex Auth** page exposes **Show each Codex account separately in the model
101
+
picker** as the single opt-in. Turning it on creates a prefix based on `main` for the main/Desktop
102
+
login and derives every other prefix from the added account's local ID. A numeric suffix resolves
103
+
provider or combo-prefix collisions. These names identify accounts; they do not represent built-in
104
+
account types. Turning the setting off hides the account-qualified rows while
105
+
preserving their configured bindings, so turning it back on restores the same picker identifiers.
106
+
Upstream ChatGPT account IDs and credentials stay server-side. Local picker prefixes stay stable if
107
+
an account's display alias is renamed; accounts added later receive a new prefix automatically while
108
+
the feature remains enabled.
109
+
110
+
Deleting an added account hides its rows but keeps its namespace binding as a fail-closed marker for
111
+
saved selectors. Re-adding the same local account ID restores the existing prefix instead of creating
112
+
a new one.
113
+
114
+
When enabled, plain native rows are hidden from the picker and replaced by readable account-labeled
115
+
entries such as `Main / 5.6 Sol` and `Side / 5.6 Sol`. Plain model ids are not removed or rerouted:
116
+
saved threads and configuration that use `gpt-*` continue to follow Pool/Direct behavior. Because
117
+
Codex exposes a flat picker rather than section metadata, the account-specific pairs stay together
118
+
ahead of ordinary routed rows; explicitly featured subagent models retain their higher priority.
110
119
111
120
These selectors do not change `activeCodexAccountId`. They bypass quota auto-switch, transient-
112
121
failure failover, affinity rebinding, and unsupported-model retry. If the exact account is missing,
113
122
cooling down, or needs reauthentication, the request fails instead of using another account. Bare
114
123
`gpt-*` models keep the configured Pool/Direct behavior.
115
124
125
+
Account-qualified ids remain explicitly routable while their picker rows are hidden. This preserves
126
+
saved selections; the visibility toggle controls discovery, not the fail-closed account binding.
127
+
116
128
Account binding follows the model selector. A bare `subagentModels` entry is projected onto its
117
129
visible account-specific rows so Codex can advertise those choices; the
118
130
client's five-model subagent limit still applies. Use qualified values in `subagentModels`,
Copy file name to clipboardExpand all lines: gui/src/i18n/de.ts
+6-6Lines changed: 6 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -580,12 +580,12 @@ export const de = {
580
580
"codexAuth.openaiMissing": "Der integrierte OpenAI-Anbieter ist nicht konfiguriert.",
581
581
"codexAuth.openaiDisabled": "Der integrierte OpenAI-Anbieter ist deaktiviert.",
582
582
"codexAuth.openProviders": "Anbieter öffnen",
583
-
"codexAuth.namespacesTitle": "Codex-Konten in der Modellauswahl anzeigen",
584
-
"codexAuth.namespacesOnDesc": "Die Auswahl zeigt jedes GPT-Modell einmal pro hinzugefügtem Codex-Konto. Ein kontobeschriftetes Modell verwendet für den gesamten Thread das Kontingent dieses Kontos und wechselt nie das Konto.",
585
-
"codexAuth.namespacesOffDesc": "GPT-Modelle folgen dem Pool- oder Direktverhalten oben. Aktiviere dies, um das genaue Konto für einen Thread zu wählen.",
586
-
"codexAuth.namespacesCompatibilityNote": "Dies ändert nur die Anzeige neuer Modelloptionen. Das aktive Pool-Konto, bestehende Threads und gespeicherte Einstellungen bleiben unverändert.",
587
-
"codexAuth.namespacesSaved": "Kontoauswahl aktualisiert. Öffne Codex erneut, falls die Liste veraltet ist.",
588
-
"codexAuth.namespacesSaveFailed": "Die Kontoauswahl konnte nicht aktualisiert werden. Die vorherige Einstellung bleibt erhalten.",
583
+
"codexAuth.namespacesTitle": "Jedes Codex-Konto separat in der Modellauswahl anzeigen",
584
+
"codexAuth.namespacesOnDesc": "Für jedes verfügbare Codex-Konto erscheint jedes GPT-Modell als eigener Eintrag. Die Bezeichnung hinzugefügter Konten wird aus der lokalen ID auf ihrer Karte abgeleitet; der integrierte Login beginnt mit Main. Bei Namenskonflikten wird eine Zahl angehängt. Die Auswahl bindet die Unterhaltung genau an dieses Konto; OpenCodex wechselt nicht und fällt nicht auf ein anderes Konto zurück.",
585
+
"codexAuth.namespacesOffDesc": "Aktiviere dies, wenn du mehrere Codex-Konten hast und ohne Abmeldung genau auswählen möchtest, welches Konto eine Unterhaltung verwendet. Beim Ausschalten werden nur diese Einträge ausgeblendet; Konten werden nicht entfernt.",
586
+
"codexAuth.namespacesCompatibilityNote": "Dies ersetzt die normalen GPT-Einträge in der Modellauswahl durch kontospezifische Optionen. Bestehende Unterhaltungen und gespeicherte Modellauswahlen behalten ihr aktuelles Routing; reine GPT-Modell-IDs behalten ihr Pool- oder Direktverhalten.",
587
+
"codexAuth.namespacesSaved": "Kontospezifische Einträge aktualisiert. Öffne Codex erneut, falls die Liste veraltet ist.",
588
+
"codexAuth.namespacesSaveFailed": "Die Modellauswahl konnte nicht aktualisiert werden. Die vorherige Einstellung bleibt erhalten.",
0 commit comments