codex-cast

在收藏的项目目录里一键启动 OpenAI Codex CLI 的 Raycast 插件。

灵感来自 claude-cast —— 同样是项目启动器思路，换成 Codex CLI 的工作流，默认终端 Terminal.app，结构精简。

---

功能

三个命令：

命令	行为
Launch Codex in Project	列收藏 / 最近 / VS Code 工作区，回车在 Terminal 里 cd 过去启动 codex
Codex Quick Continue	直接对最近一次项目跑 codex resume --last（无 UI，秒进续聊）
Add Codex Project	用文件选择器把目录加入收藏

Launch Project 内置快捷键

快捷键	动作
Enter	启动新会话（codex）
⌘R	续聊（codex resume --last）
⌘P	带初始 prompt 启动（codex "your prompt"）
⌘F	收藏 / 取消收藏
⌘O	VS Code 打开当前项目
⌘⇧T	普通 Terminal 打开（不启动 codex）
⌘⇧C	复制项目路径

---

安装

需要 macOS、Raycast 和 Codex CLI（brew install codex 或 npm i -g @openai/codex）。

git clone https://github.com/ThinkerJack/codex-cast.git
cd codex-cast
npm install
npm run dev

npm run dev 会触发 Raycast 自动注册这个本地扩展。注册一次后即使退出 dev 进程，扩展仍保留在 Raycast 里 —— 改了代码再跑 npm run dev 重新加载即可。

---

配置（Raycast Preferences → CodexCast）

字段	说明
Codex Path	codex 二进制路径，默认自动探测 /opt/homebrew/bin/codex、/usr/local/bin/codex、~/.cargo/bin/codex 等
Extra Codex Args	每次启动追加的参数，例如 --model gpt-5 或 -c sandbox_permissions='["disk-full-read-access"]'

---

多设备同步

两台 Mac 之间靠 git 同步：

git pull
npm install   # package.json 有变化时
npm run dev   # 让 Raycast 重新注册扩展

---

开发

npm run build      # 编译验证
npm run lint       # ESLint 检查
npm run fix-lint   # 自动修复

源码结构：

src/
├── launch-project.tsx     # 主命令（List + Form）
├── quick-continue.tsx     # no-view 命令
├── add-project.tsx        # 添加收藏的表单
└── lib/
    ├── codex-cli.ts       # 检测 codex 二进制
    ├── terminal.ts        # AppleScript 启动 Terminal
    └── projects.ts        # 收藏 / 最近 / VS Code workspace 集成

---

License

MIT