shadowzzh / cx
Codex CLI 交互式启动器
README.TXT
简介
cx 是一个轻量级命令行启动器,用来简化 Codex CLI 的启动流程。
功能特性
- 交互式菜单启动 Codex
- 已传入的参数自动跳过,不重复询问
- 支持
reasoning/yolo/model动态补全 - 支持在交互菜单中回退上一步
- 检测到
fzf时默认启用增强交互 - 支持
macOS/Linux - 支持
bash/zsh
安装
环境要求
- 已安装
codex bash可用fzf可选,安装后会自动启用增强交互
快速安装
curl -fsSL https://raw.githubusercontent.com/Shadowzzh/cx/main/scripts/install.sh | bash
手动安装
git clone https://github.com/Shadowzzh/cx.git
cd cx
bash scripts/install.sh
卸载
curl -fsSL https://raw.githubusercontent.com/Shadowzzh/cx/main/scripts/uninstall.sh | bash
bash scripts/uninstall.sh
使用
基础示例
cx
cx yolo
cx gpt-5.5
cx xhigh
cx gpt-5.4
cx yolo xhigh
cx yolo xhigh gpt-5.4
cx no-yolo high
规则说明
- 传了什么参数,就跳过对应菜单
- 缺什么参数,就只补什么菜单
- 三个维度都齐了,就直接启动
菜单回退
- 从第二个交互步骤开始,可输入
b或back返回上一步 fzf菜单支持ctrl-b返回上一步- 同时提供显式菜单项
返回上一步 - 仅能回退当前这次交互里实际出现过的步骤
默认值
reasoning:mediumyolo:yesmodel:gpt-5.4
支持的思考等级
lowmediumhighxhigh
支持的 model
gpt-5.4gpt-5.5gpt-5.3-codexgpt-5.2-codexgpt-5.1-codex-maxgpt-5.2gpt-5.1-codex-mini
开发
项目结构
├── bin/
│ └── cx
├── scripts/
│ ├── install.sh
│ └── uninstall.sh
├── tests/
│ └── cx_smoke_test.sh
├── docs/
│ ├── demo.gif
│ └── logo.svg
└── .github/
└── workflows/
└── smoke.yml
本地检查
bash -n bin/cx
bash -n scripts/install.sh
bash -n scripts/uninstall.sh
bash tests/cx_smoke_test.sh
设计原则
- 核心逻辑保持单文件,方便安装和维护
- 安装脚本只做最小配置,不隐式修改太多用户环境
- 交互保持轻量,
fzf作为可选增强,未安装时回退 shell 原生能力