ProjectsAugust 4, 2026

Codex-- Manager

What it is

Codex-- Manager is a deliberately small macOS client for switching Codex relay providers, managing local session lifecycle, and diagnosing configuration conflicts. It is a trimmed fork of Codex++ Manager with renderer injection, launchers, marketplaces, auto-update, and the local protocol proxy removed.

Why it exists

Provider switching should not take ownership of unrelated Codex context. Codex-- snapshots the live mcp_servers, skills, and plugins tables before every provider write and grafts their original TOML content back afterward. The manager also separates active and archived sessions, uses Codex-native archive and restore operations, and keeps automatic maintenance opt-in with a preview before the first run.

Scope

Relay provider profiles with OAuth and API key combinations
Context-protected writes to config.toml and auth.json
Active and archived session pagination
Native archive and restore with postcondition checks
Read-only active-session provider compatibility checks
Environment conflict diagnostics

Distribution

The current public release targets Apple Silicon Macs. It uses ad-hoc signing and is not notarized, so first launch may require Open Anyway in macOS Privacy & Security. Existing installations update by replacing /Applications/Codex-- Manager.app. User settings remain under ~/.codex-session-delete/, and the application does not include an auto-updater.

这是什么

Codex-- Manager 是一个刻意保持精简的 macOS 客户端，用于切换 Codex 中转供应商、管理本地会话生命周期和诊断配置冲突。它从 Codex++ Manager 裁剪而来，删除了渲染注入、launcher、市场、自动更新和本地协议代理。

为什么需要它

供应商切换不应该接管无关的 Codex Context。Codex-- 会在每次供应商写入前快照实时的 mcp_servers、skills 和 plugins 表，并在写入结束后把原始 TOML 内容回植。管理器同时区分活动与归档会话，使用 Codex 原生归档和恢复语义，并让自动维护保持选择加入，首次执行前必须先确认预览。

范围

OAuth 与 API Key 混合的中转供应商 profile
对 config.toml 与 auth.json 的 Context 保护写入
活动与归档会话分页
带后置条件检查的原生归档和恢复
只读的活动会话供应商兼容性检查
环境变量冲突诊断

分发

当前公开版本面向 Apple Silicon Mac，使用 ad-hoc 签名且尚未公证。首次启动可能需要在 macOS「隐私与安全性」中选择「仍要打开」。现有安装通过覆盖 /Applications/Codex-- Manager.app 更新。用户设置保存在 ~/.codex-session-delete/，应用不包含自动更新器。

链接

Related projects

JumpOTP

面向授权 SSH／JumpServer 会话的按需 TOTP 助手。仅在严格匹配提示后调用已解锁的 Bitwarden CLI，每条连接最多自动提交一次，并保留可见手输回退。

Codex-- Manager

What it is

Why it exists

Scope

Distribution

Links

这是什么

为什么需要它

范围

分发

链接

Related projects

JumpOTP

Codex Doubao Pets

grill-loop

Slash Saver

deep-grill

Mingjian AI Services

opencode-sub2api-haiku-fix

opencode-metrics

opencode-plugin-fixes

opencode-vibe-island-plugin

OpenCode Themes

wechat-mp-publisher

SIGINT

MdictLive

SiliconLM

mdx2apple