Codex工作区
Codex Workspace是一个VS Code扩展,它将分散的Codex配置和操作资产集中到一个地方,这样您就可以管理它们而不会丢失。它可以让你处理从 config.toml 和 AGENTS.md 子代理、技能、命令、模板、MCP服务器、对话历史、功能标志、钩子诊断和已安装的插件元数据——所有这些都在一个统一的工作流程中。花更少的时间寻找“那东西住在哪里”,花更多的时间完成工作。
快速开始
- 确保Codex主目录(通常
~/.codex)存在。 - 打开 Codex工作区 从VS代码活动栏。
- 从每个探索标题栏中,您可以:
- 添加文件/文件夹 - 打开目标文件夹 - 刷新 - 同步 - 打开管理器视图
- 打开 食品法典经理 从“核心”视图或“命令选项板”中,然后选中:
- 历史 - 试剂诊断 - 受信任的目录 - 功能标志 - 钩子 - 插件
主要特点
- 专用浏览视图
Codex Manager,Sub Agents,Skills,Commands,MCP Server,以及Templates - 一键打开
config.toml,AGENTS.md,AGENTS.override.md、提示、技能、模板和代理定义文件 - 直接从支持的浏览视图中添加、重命名和删除文件/文件夹
- 外部文件夹和核心、命令、技能、模板和子代理之间的双向同步
- 跨项目/工作区/用户/系统的统一技能列表
- 跨项目/工作区/用户的统一子代理列表
- 技能、子代理和MCP服务器的专用管理器视图
Codex Manager它汇集了对话历史、代理加载链、可信目录、功能标志、钩子和插件- 插件可见性和启用/禁用管理集中在
Plugins选项卡,而不是技能/子代理/MCP探索和管理器视图
重要提示: 通过解析显示对话历史记录 $CODEX_HOME/sessions/.../rollout-*.jsonl。如果Codex更改其日志格式,历史选项卡可能会停止工作。视图
食品法典经理
从Core Explore视图,您可以访问:
config.tomlAGENTS.mdAGENTS.override.md- 打开
.codex文件夹 - 打开
Codex Manager - 核心同步
codex-workspace.codexFolder
Codex Manager 以编辑器Webview打开,包括以下选项卡:
History
- 可搜索的对话历史记录 - 列表和详细信息窗格的独立滚动 - 复制用户/助理文本 - 可选推理显示(取决于设置)
AGENTS Loading Chain
- 对当前有效的AGENTS相关文件的诊断 - 检查被忽略的候选人、问题和详细的候选人 - 显示基线工作区
Trusted Directory
- 列出受信任的项目 config.toml - 添加和删除受信任的目录
Feature Flags
- 查看主要Codex功能标志的默认值、有效值和配置值 - 打开/关闭支持的标志
Hooks
- 用户/项目挂钩源的诊断 - 根据信任状态将项目挂钩显示为启用/禁用 - 创建并打开 hooks.json / config.toml
Plugins
- 从本地插件缓存中列出已安装的插件 - 显示清单衍生元数据、打包的技能/MCP/Apps/代理和市场源详细信息 - 从以下位置切换插件启用/禁用 [plugins.""] 当清单和 config.toml 处于可写状态
命令
管理以下文件 ~/.codex/prompts 并将其与同步 codex-workspace.promptsFolder.
保留此“探索”视图是为了兼容。这里没有添加较新的“经理风格”功能(如技能、子代理和MCP)。
技能
在单个Explore视图中从多个存储位置管理技能:
Project Skills:更喜欢project/.agents/skills;倒退到project/.codex/skills如不存在Workspace Skills:~/.codex/skillsUser Skills:~/.agents/skillsSystem Skills:~/.codex/skills/.system
新的项目技能总是在 project/.agents/skills.\ 从根目录添加时,可以选择项目/工作区/用户。\ System Skills 显示为只读。\ 在 Skill Manager,您可以搜索、打开和切换启用/禁用。
子代理
从多个存储位置管理子代理:
Project Agents:更喜欢project/.codex/agents;倒退到project/.agents/agents如不存在Workspace Agents:~/.codex/agentsUser Agents:~/.codex/agents
新项目代理始终在中创建 project/.codex/agents.\ AGENTS Manager 允许您搜索和管理启用/禁用状态。\ 您可以从浏览图标中识别启用/禁用状态。
MCP服务器
MCP Server 在探索视图中保持快速开/关控制,并提供专用 MCP Manager.
在 MCP Manager,您可以:
- 搜索
- 添加、编辑和删除服务器定义
- 切换启用/禁用
- 编辑的关键字段
stdio/http运输 - 编辑和验证
env键值对 - 隐藏同伴
.env从列表中删除条目,同时在删除父服务器时将它们一起删除
模板
管理下的模板 ~/.codex/codex-templates.支持创建文件时选择模板并与同步 codex-workspace.templatesFolder.
命令
| 命令 | 描述 |
|---|---|
Codex Workspace: Open Codex Manager | 打开 Codex Manager 网络视图 |
Codex Workspace: Open Skill Manager | 打开 Skill Manager 网络视图 |
Codex Workspace: Open AGENTS Manager | 打开 AGENTS Manager 网络视图 |
Codex Workspace: Open MCP Manager | 打开 MCP Manager 网络视图 |
Codex Workspace: Organize config.toml | 管理的组 config.toml 部分和创建 ~/.codex/.codex-workspace/config.toml.bk 重写前 |
Codex Workspace: Open .codex Folder | 打开 .codex 操作系统文件资源管理器中的文件夹 |
设置
| 关键字 | 类型 | 默认值 | 描述 |
|---|---|---|---|
codex-workspace.codexFolder | 字符串 | "" | 核心文件的同步目标,例如 config.toml, AGENTS.md,以及 AGENTS.override.md |
codex-workspace.promptsFolder | 字符串 | "" | 同步目标 Commands |
codex-workspace.skillsFolder | 字符串 | "" | 同步工作区技能目标(~/.codex/skills) |
codex-workspace.templatesFolder | 字符串 | "" | 同步目标 Templates |
codex-workspace.agentFolder | 字符串 | "" | 子代理的同步目标 |
codex-workspace.maxHistoryCount | 编号 | 100 | 显式设置时显示的最大历史项目数。如果未设置,则显示所有检测到的历史项目。 |
codex-workspace.incrudeReasoningMessage | 布尔值 | false | 在历史预览中包含推理消息。保留密钥名称以实现向后兼容性。 |
许可证
麻省理工学院
