@hunyed15/codecgc 0.1.0

package/codecgc/reference/role-model.md

@@ -0,0 +1,128 @@
+# CodeCGC 角色模型
+
+## 1. 目的
+
+CodeCGC 故意把三个模型放在不同角色上。
+
+它们不是三个平级程序员，也不是谁都可以随意接管谁的工作。
+它们是在同一条交付系统里承担不同责任的 owner。
+
+## 2. 核心定位
+
+### Claude
+
+Claude 是工作流总控。
+
+Claude 负责：
+
+- 需求澄清
+- 范围定义
+- roadmap 拆解
+- 架构设计
+- 接口约束
+- 任务拆分
+- 执行器选择
+- 审核判断
+- 验收判断
+- 产物回写
+- 发布就绪判断
+
+Claude 不负责直接编写前端或后端业务代码。
+
+### Gemini
+
+Gemini 是前端实现 owner。
+
+Gemini 负责：
+
+- 页面与组件实现
+- 样式与交互改动
+- 前端状态管理变更
+- 前端 bug 修复
+- 前端测试
+- 浏览器可见行为修正
+- 可访问性与 UI 正确性检查
+
+Gemini 不负责后端业务逻辑。
+
+### Codex
+
+Codex 是后端实现 owner。
+
+Codex 负责：
+
+- 服务与 API 实现
+- 仓储与持久化改动
+- 后端业务逻辑
+- 后端 bug 修复
+- 后端测试
+- 脚本与自动化
+- 后端执行链路调试
+- 偏工程化的 CI 或基础设施代码任务
+
+Codex 不负责前端 UI 行为。
+
+## 3. Claude 不只是“规划器”
+
+Claude 不能被缩减成只会写 plan 的角色。
+
+更准确地说，Claude 同时接近下面几类职责：
+
+- 产品经理
+- 架构师
+- 技术负责人
+- 项目经理
+- reviewer
+- acceptance owner
+
+一句话概括：
+
+Claude 是整个系统的工作流操盘手。
+
+## 4. 归属规则
+
+每一个会改代码的步骤，都必须且只能有一个实现 owner：
+
+- 前端步骤 -> Gemini
+- 后端步骤 -> Codex
+
+如果一个步骤没有明确 owner，这个步骤就还没 ready，Claude 必须先拆分或重设计。
+
+## 5. Shared Scope 规则
+
+shared scope 不是第三个写代码的人。
+
+它通常意味着三种情况之一：
+
+1. 前端共享工作
+2. 后端共享工作
+3. 真正跨边界的工作
+
+其中：
+
+- 前端共享工作仍然归 Gemini
+- 后端共享工作仍然归 Codex
+- 真正跨边界的工作先归 Claude 做拆分与契约控制，再拆成可执行子步骤
+
+## 6. 升级判断规则
+
+当执行结果存在不确定性时，下一步由 Claude 决定：
+
+- 通过
+- 追加一个更小的修复步骤
+- 拆出新的跟进工作
+- 回到设计
+- 回到 roadmap
+
+Gemini 和 Codex 的责任是执行 scoped work。
+Claude 的责任是决定这些工作是否已经足够。
+
+## 7. 产品原则
+
+CodeCGC 不是“三个模型自由协作”。
+
+它是一套受控工作流：
+
+- Claude 是控制器
+- Gemini 是前端执行器
+- Codex 是后端执行器

package/codecgc/reference/runtime-boundary.md

@@ -0,0 +1,72 @@
+# CodeCGC 运行时边界
+
+## 1. 目的
+
+这份文档用来区分“真实运行时产物”和“示例 / 校验用 fixture”。
+
+这个边界很重要，因为 `route / build / fix / review` 会把 `codecgc/` 下的文件当成真实工作流状态来消费。
+
+## 2. 真实运行时目录
+
+下面这些目录属于当前活跃产品状态：
+
+- `codecgc/features/`
+- `codecgc/issues/`
+- `codecgc/execution/`
+
+下面这些目录属于 fixture 校验根：
+
+- `codecgc/fixtures/features/`
+- `codecgc/fixtures/issues/`
+- `codecgc/fixtures/execution/`
+
+fixture 不只是“示例文本”，它们同样会参与本地回归与行为验证，因此不能随便混放。
+
+## 3. fixture 风险
+
+在本地开发阶段，一些 demo 或校验文件可能长期存在。
+
+这可以接受，但必须遵守一条规则：
+
+- 校验必须是串行且显式的
+
+不要假设 `codecgc/execution/` 里最新的 audit 一定对应当前工作流。
+所有控制逻辑都必须按精确步骤身份匹配。
+
+## 4. 当前控制规则
+
+当前运行时遵守下面这些规则：
+
+- `route` 只检查当前 `pending` 的可执行步骤
+- audit 必须按精确 `task_id` 匹配
+- review 必须按精确 `task_id` 与 `step_number` 匹配
+- `artifact_class` 会从工作流产物继续传递到 audit 元数据
+- `dry-run` audit 只是预演证据
+- 只有非 `dry-run` 且成功 `done` 的执行结果，才算 review-ready
+
+## 5. 操作建议
+
+当你在校验一个 fixture 工作流时，建议顺序是：
+
+1. 先看 checklist 或 fix 文件
+2. 确认当前哪一步是 `pending`
+3. 只检查与该步骤匹配的 audit
+4. 再运行 `route`
+5. 然后运行 `build` 或 `fix`
+6. 真实执行完成后再写 review
+
+## 6. 持续清理方向
+
+当前 fixtures 已经有目录级隔离，但后续仍应继续收口：
+
+- 让长期产品示例与临时校验文件分得更清楚
+- 保持 `artifact_class` 作为机器意图标记
+- 继续规范历史 audit 路径
+
+如果历史 audit 里还保留旧仓库名或旧执行根，可使用：
+
+- `python scripts/normalize_codecgc_audits.py`
+
+如果历史 demo 工作流还混在活跃目录里，可使用：
+
+- `python scripts/migrate_demo_workflows_to_fixtures.py`

package/codecgc/reference/shared-conventions.md

@@ -0,0 +1,93 @@
+# CodeCGC 共享约定
+
+## 1. 适用范围
+
+这份文档定义 CodeCGC 的产品层通用约定。
+
+当前固定角色分工是：
+
+- Claude：规划、拆分、路由、审核、验收
+- Gemini：前端实现
+- Codex：后端实现
+
+如果某项设计或实现与这套分工冲突，应优先怀疑该设计是否偏离了 CodeCGC 蓝图。
+
+## 2. 目录模型
+
+当前活跃运行时根目录是 `codecgc/`。
+
+主要目录职责如下：
+
+- `codecgc/reference/`：参考说明与契约
+- `codecgc/cgc*`：技能定义
+- `codecgc/features/`：功能开发工作流产物
+- `codecgc/issues/`：问题修复工作流产物
+- `codecgc/execution/`：执行审计产物
+- `codecgc/requirements/`、`architecture/`、`roadmap/`、`compound/`：长期项目记忆
+- `scripts/`：任务打包、运行时控制与 MCP 桥接
+
+## 3. 产品级硬规则
+
+所有代码改动步骤都必须遵守下面这些规则：
+
+- 前端范围必须交给 Gemini
+- 后端范围必须交给 Codex
+- shared 范围必须先拆分
+- Claude 不直接写受路由保护的业务代码
+
+这套规则通过两层落地：
+
+1. 工作流层：`cgc-build` 与 `cgc-fix`
+2. guardrail 层：`.claude/hooks/route-edit.ps1`
+
+## 4. 当前公开命令面
+
+当前对外公开命令面是：
+
+- `cgc`
+- `cgc-install`
+- `cgc-entry`
+- `cgc-plan`
+- `cgc-build`
+- `cgc-fix`
+- `cgc-review`
+- `cgc-route`
+- `cgc-status`
+- `cgc-doctor`
+- `cgc-package-audit`
+
+其中：
+
+- `cgc` 是产品总入口
+- 其他命令是在阶段已明确时使用
+
+旧 `cs-*` 命令已经不属于 CodeCGC。
+
+## 5. 产物归档规则
+
+所有新的工作流产物都应归档到 `codecgc/` 下的正确目录。
+
+推荐的长期归档家族包括：
+
+- `codecgc/requirements/`
+- `codecgc/architecture/`
+- `codecgc/roadmap/`
+- `codecgc/features/`
+- `codecgc/issues/`
+- `codecgc/compound/`
+
+不要再把长期事实散落在旧命令体系或临时顶层文档中。
+
+## 6. 实现步骤最低要求
+
+任何会改代码的实现或修复步骤，都必须带有机器可执行的范围元数据。
+
+至少应定义：
+
+- 目标类型：frontend 或 backend
+- `target_paths`
+- `task_summary`
+- 硬约束
+- 当前步骤的验收标准
+
+如果这些内容写不清楚，就说明步骤还没 ready，应该回到拆分或设计，而不是强行执行。

package/codecgc/reference/workflow-scaffold.md

@@ -0,0 +1,57 @@
+# CodeCGC 工作流骨架
+
+## 1. 目的
+
+这份文档定义 CodeCGC 在新工作开始时的最小产物骨架。
+
+当前创建入口：
+
+- `scripts/init_codecgc_workflow.py`
+
+## 2. Feature 骨架
+
+初始化 feature 时会创建：
+
+- `codecgc/features/YYYY-MM-DD-{slug}/{slug}-design.md`
+- `codecgc/features/YYYY-MM-DD-{slug}/{slug}-checklist.yaml`
+- `codecgc/features/YYYY-MM-DD-{slug}/{slug}-acceptance.md`
+
+默认情况下，checklist 会包含第一个 `codecgc` 步骤契约占位。
+
+如果规划阶段识别到前后端混合目标路径，checklist 可以扩展成多个可执行步骤，而不只保留单一占位步骤。
+
+如果规划阶段识别到共享路径或未知路径，也可以加入只用于规划澄清的步骤，这些步骤必须先被解决，后续才能执行。
+
+每个拆分后的可执行步骤，也可以拥有自己的：
+
+- action label
+- task summary
+- acceptance lines
+
+这样执行器契约始终保持局部化，而不是依赖上层自由解释。
+
+## 3. Issue 骨架
+
+初始化 issue 时会创建：
+
+- `codecgc/issues/YYYY-MM-DD-{slug}/{slug}-report.md`
+- `codecgc/issues/YYYY-MM-DD-{slug}/{slug}-analysis.md`
+- `codecgc/issues/YYYY-MM-DD-{slug}/{slug}-fix.yaml`
+- `codecgc/issues/YYYY-MM-DD-{slug}/{slug}-fix-note.md`
+
+默认情况下，fix YAML 会包含第一个 `codecgc` 修复步骤契约占位。
+
+如果问题范围是混合的，也可以扩展成多个可执行修复步骤，并在必要时插入只用于规划澄清的步骤。
+
+## 4. 产品规则
+
+feature 与 issue 产物都直接落在 `codecgc/` 运行时根目录下：
+
+- feature 产物在 `codecgc/features/`
+- issue 产物在 `codecgc/issues/`
+
+## 5. 规划规则
+
+`cgc-plan` 应先创建工作流骨架，再由 `cgc-build` 或 `cgc-fix` 执行。
+
+执行层默认假设目录、步骤契约和基本骨架已经存在。

package/codexmcp/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 guda.studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/codexmcp/README.md

@@ -0,0 +1,294 @@
+![这是图片](./images/title.png)
+
+<div align="center">
+
+
+**让 Claude Code 与 Codex 无缝协作** 
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![Python Version](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/) [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io)[![Share](https://img.shields.io/badge/share-000000?logo=x&logoColor=white)](https://x.com/intent/tweet?text=CodexMCP：让%20Claude%20Code%20与%20Codex%20无缝协作%20https://github.com/GuDaStudio/codexmcp%20%23AI%20%23Coding%20%23MCP) [![Share](https://img.shields.io/badge/share-1877F2?logo=facebook&logoColor=white)](https://www.facebook.com/sharer/sharer.php?u=https://github.com/GuDaStudio/codexmcp) [![Share](https://img.shields.io/badge/share-FF4500?logo=reddit&logoColor=white)](https://www.reddit.com/submit?title=CodexMCP：让%20Claude%20Code%20与%20Codex%20无缝协作&url=https://github.com/GuDaStudio/codexmcp) [![Share](https://img.shields.io/badge/share-0088CC?logo=telegram&logoColor=white)](https://t.me/share/url?url=https://github.com/GuDaStudio/codexmcp&text=CodexMCP：让%20Claude%20Code%20与%20Codex%20无缝协作)
+
+
+⭐ 在GitHub上给我们点星~您的支持对我们意义重大！ 🙏😊
+
+[English](./docs/README_EN.md) | 简体中文
+
+</div>
+
+---
+
+## 一、项目简介 
+
+在当前 AI 辅助编程生态中，**Claude Code** 擅长架构设计与全局思考，而 **Codex** 在代码生成与细节优化上表现卓越。**CodexMCP** 作为两者之间的桥梁，通过 MCP 协议让它们优势互补：
+
+- **Claude Code**：负责需求分析、架构规划、代码重构
+- **Codex**：负责算法实现、bug 定位、代码审查
+- **CodexMCP**：管理会话上下文，支持多轮对话与并行任务
+
+相比官方 Codex MCP 实现，CodexMCP 引入了**会话持久化**、**并行执行**和**推理追踪**等企业级特性，让 AI 编程助手之间的协作更加智能高效。CodexMCP 与官方 Codex MCP 区别一览：
+
+
+| 特性 | 官方版 | CodexMCP |
+|------|--------|----------|
+| 基本 Codex 调用 | √ | √ |
+| 多轮对话 | × | √ |
+| 推理详情追踪 | × | √ |
+| 并行任务支持 | ×  | √  |
+| 错误处理 | ×  | √  |
+
+
+---
+
+## 二、快速开始
+
+### 0. 前置要求
+
+请确保您已成功**安装**和**配置**claude code与codex两个编程工具。
+- [Claude Code 安装指南](https://docs.claude.com/docs/claude-code)
+- [Codex CLI 安装指南](https://developers.openai.com/codex/quickstart)
+
+> [!IMPORTANT]
+> 请确保您的claude code版本在v2.0.56以上；codex cli版本在v0.61.0以上！
+
+请确保您已成功安装[uv工具](https://docs.astral.sh/uv/getting-started/installation/)：
+
+- Windows
+  在Powershell中运行以下命令：
+  ```
+  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+  ```
+
+- Linux/macOS
+  使用curl/wget下载并安装:
+  ```
+  curl -LsSf https://astral.sh/uv/install.sh | sh #使用curl
+
+  wget -qO- https://astral.sh/uv/install.sh | sh #使用wget
+  ```
+
+**注意，我们极力推荐Windows用户在WSL中运行本项目！**
+
+<!-- 如果您正在为订阅和配置而忧愁，我们非常欢迎您[积极联系我们](https://cc.guda.studio)。 -->
+
+### 1. 安装步骤
+
+**1.1** 移除官方 Codex MCP（如果已安装）。
+
+```bash
+claude mcp remove codex
+```
+
+**1.2** 安装 CodexMCP。
+
+```bash
+claude mcp add codex -s user --transport stdio -- uvx --from git+https://github.com/GuDaStudio/codexmcp.git codexmcp
+```
+
+**1.3** 验证安装。在 **终端** 中运行：
+
+```
+claude mcp list
+```
+
+> [!IMPORTANT]
+> 如果看到如下描述，说明安装成功！
+>  `codex: uvx --from git+https://github.com/GuDaStudio/codexmcp.git codexmcp - ✓ Connected` 
+
+**1.4** 可选择默认允许claude code自动与codex交互，在`~/.claude/settings.json`添加 `mcp__codex__codex` allow项
+![](images/image.png)
+
+### 2. 配置claude code提示词（可选）
+
+为使claude code更好完成与codex的协同工作，我们**极力推荐您在 `~/.claude/CLAUDE.md`中添加以下内容**
+
+<details>
+<summary>展开查看prompt</summary>
+
+
+```
+## Core Instruction for CodeX MCP
+
+在任何时刻，你必须思考当前过程可以如何与codex进行协作，如何调用Codex 为你提供的MCP工具作为你客观全面分析的保障。
+其中你**务必执行**以下几个步骤：
+**1** 在你对用户需求形成初步分析后，将用户需求、初始思路告知codex，并要求其完善需求分析和实施计划。
+**2** 在实施具体编码任务前，**必须向codex索要代码实现原型（要求codex仅给出unified diff patch，严禁对代码做任何真实修改）**。在获取代码原型后，你**只能以此为逻辑参考，再次对代码修改进行重写**，形成企业生产级别、可读性极高、可维护性极高的代码后，才能实施具体编程修改任务。
+**3** 无论何时，只要完成切实编码行为后，**必须立即使用codex review代码改动和对应需求完成程度**。
+**4** codex只能给出参考，你**必须有自己的思考，甚至需要对codex的回答提出置疑**。尽信书则不如无书，你与codex的最终使命都是达成统一、全面、精准的意见，所以你们必须不断争辩已找到通向真理的唯一途径。
+
+
+## Codex Tool Invocation Specification
+
+ 1. 工具概述
+
+  codex MCP 提供了一个工具 `codex`，用于执行 AI 辅助的编码任务。该工具**通过 MCP 协议调用**，无需使用命令行。
+
+  2. 工具参数
+
+  **必选**参数：
+  - PROMPT (string): 发送给 codex 的任务指令
+  - cd (Path): codex 执行任务的工作目录根路径
+
+  可选参数：
+  - sandbox (string): 沙箱策略，可选值：
+    - "read-only" (默认): 只读模式，最安全
+    - "workspace-write": 允许在工作区写入
+    - "danger-full-access": 完全访问权限
+  - SESSION_ID (UUID | null): 用于继续之前的会话以与codex进行多轮交互，默认为 None（开启新会话）
+  - skip_git_repo_check (boolean): 是否允许在非 Git 仓库中运行，默认 False
+  - return_all_messages (boolean): 是否返回所有消息（包括推理、工具调用等），默认 False
+  - image (List[Path] | null): 附加一个或多个图片文件到初始提示词，默认为 None
+  - model (string | null): 指定使用的模型，默认为 None（使用用户默认配置）
+  - yolo (boolean | null): 无需审批运行所有命令（跳过沙箱），默认 False
+  - profile (string | null): 从 `~/.codex/config.toml` 加载的配置文件名称，默认为 None（使用用户默认配置）
+
+  返回值：
+  {
+    "success": true,
+    "SESSION_ID": "uuid-string",
+    "agent_messages": "agent回复的文本内容",
+    "all_messages": []  // 仅当 return_all_messages=True 时包含
+  }
+  或失败时：
+  {
+    "success": false,
+    "error": "错误信息"
+  }
+
+  3. 使用方式
+
+  开启新对话：
+  - 不传 SESSION_ID 参数（或传 None）
+  - 工具会返回新的 SESSION_ID 用于后续对话
+
+  继续之前的对话：
+  - 将之前返回的 SESSION_ID 作为参数传入
+  - 同一会话的上下文会被保留
+
+  4. 调用规范
+
+  **必须遵守**：
+  - 每次调用 codex 工具时，必须保存返回的 SESSION_ID，以便后续继续对话
+  - cd 参数必须指向存在的目录，否则工具会静默失败
+  - 严禁codex对代码进行实际修改，使用 sandbox="read-only" 以避免意外，并要求codex仅给出unified diff patch即可
+
+  推荐用法：
+  - 如需详细追踪 codex 的推理过程和工具调用，设置 return_all_messages=True
+  - 对于精准定位、debug、代码原型快速编写等任务，优先使用 codex 工具
+
+  5. 注意事项
+
+  - 会话管理：始终追踪 SESSION_ID，避免会话混乱
+  - 工作目录：确保 cd 参数指向正确且存在的目录
+  - 错误处理：检查返回值的 success 字段，处理可能的错误
+
+```
+
+</details>
+
+
+
+---
+
+## 三、工具说明
+
+<details>
+<summary>点击查看codex工具参数说明</summary>
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `PROMPT` | `str` | ✅ | - | 发送给 Codex 的任务指令 |
+| `cd` | `Path` | ✅ | - | Codex 工作目录根路径 |
+| `sandbox` | `Literal` | ❌ | `"read-only"` | 沙箱策略：`read-only` / `workspace-write` / `danger-full-access` |
+| `SESSION_ID` | `UUID \| None` | ❌ | `None` | 会话 ID（None 则开启新会话） |
+| `skip_git_repo_check` | `bool` | ❌ | `False` | 是否允许在非 Git 仓库运行 |
+| `return_all_messages` | `bool` | ❌ | `False` | 是否返回完整推理信息 |
+| `image` | `List[Path] \| None` | ❌ | `None` | 附加图片文件到初始提示词 |
+| `model` | `str \| None` | ❌ | `None` | 指定使用的模型（默认使用用户配置） |
+| `yolo` | `bool \| None` | ❌ | `False` | 无需审批运行所有命令（跳过沙箱） |
+| `profile` | `str \| None` | ❌ | `None` | 从 `~/.codex/config.toml` 加载的配置文件名称 |
+
+</details>
+
+<details>
+<summary>点击查看codex工具返回值结构</summary>
+
+**成功时：**
+```json
+{
+  "success": true,
+  "SESSION_ID": "550e8400-e29b-41d4-a716-446655440000",
+  "agent_messages": "Codex 的回复内容...",
+  "all_messages": [...]  // 仅当 return_all_messages=True 时包含
+}
+```
+
+**失败时：**
+```json
+{
+  "success": false,
+  "error": "错误信息描述"
+}
+```
+
+</details>
+
+---
+
+## 四、FAQ
+
+<details>
+<summary>Q1: 是否需要额外付费？</summary>
+
+ **CodexMCP 本身完全免费开源，无需任何额外付费！** 
+
+</details>
+
+<details>
+<summary>Q2: 并行调用会冲突吗？</summary>
+
+不会。每个调用使用独立的 `SESSION_ID`，完全隔离。
+
+</details>
+
+
+---
+
+## 🤝 贡献指南
+
+<details>
+<summary>我们欢迎所有形式的贡献！</summary>
+
+### 开发环境配置
+
+```bash
+# 克隆仓库
+git clone https://github.com/GuDaStudio/codexmcp.git
+cd codexmcp
+
+# 安装依赖
+uv sync
+```
+
+### 提交规范
+
+- 遵循 [Conventional Commits](https://www.conventionalcommits.org/)
+- 提交测试用例
+- 更新文档
+
+</details>
+
+
+
+---
+
+## 📄 许可证
+
+本项目采用 [MIT License](LICENSE) 开源协议。
+Copyright (c) 2025 [guda.studio](mailto:gudaclaude@gmail.com)
+
+---
+<div align="center">
+
+## 用 🌟 为本项目助力~
+[![Star History Chart](https://api.star-history.com/svg?repos=GuDaStudio/codexmcp&type=date&legend=top-left)](https://www.star-history.com/#GuDaStudio/codexmcp&type=date&legend=top-left)
+
+</div>

package/codexmcp/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "codexmcp"
+version = "0.7.4"
+description = "FastMCP server wrapping the Codex CLI."
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "mcp[cli]>=1.20.0",
+    "pydantic>=2.0",
+]
+authors = [
+    { name = "guda.studio", email = "gudaclaude@gmail.com" },
+]
+license = { text = "MIT" }
+keywords = ["mcp", "fastmcp", "codex"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/GuDaStudio/codexmcp"
+
+[project.scripts]
+codexmcp = "codexmcp.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/codexmcp"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/codexmcp", "README.md", "LICENSE"]