codex-agent-manager/docs/project.md

Project Documentation

Goal

构建一个本机 Codex 智能体管理台，用中文管理 agent 配置、项目运行状态、动态工作流和安全写回流程。

Architecture

Go 后端提供 localhost HTTP API，Vue 3 + Vite 前端提供中文工作台界面。后端只读访问 Codex SQLite 状态库，安全读取 .codex 配置，并仅在用户确认后写回 .codex/agents/*.toml。

Configuration

• CODEX_HOME: 默认 /Users/yoilun/.codex
• 后端监听地址：默认 127.0.0.1:18083
• 前端开发地址：默认 127.0.0.1:13083

Runbook

实施完成后记录实际命令。

Security Boundaries

• 不读取 .codex/auth.json。
• 不写入 Codex SQLite。
• .codex/agents/*.toml 写回必须先备份。

Known Risks

• Codex 内部 SQLite schema 可能变化。
• 运行状态由多来源推断，必须显示置信度。