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 |
在历史预览中包含推理消息。保留密钥名称以实现向后兼容性。 |
许可证
麻省理工学院
