AI导哈

Codex配置管理扩展

Codex Workspace是一个VS Code扩展，用于集中管理和操作Codex的配置和资源，包括子代理、技能、命令、模板等，提高开发效率。

  • by Knworks
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Knworks/codex-workspace

使用说明

Codex工作区

Codex Workspace是一个VS Code扩展，它将分散的Codex配置和操作资产集中到一个地方，这样您就可以管理它们而不会丢失。它可以让你处理从 config.toml 和 AGENTS.md 子代理、技能、命令、模板、MCP服务器、对话历史、功能标志、钩子诊断和已安装的插件元数据——所有这些都在一个统一的工作流程中。花更少的时间寻找“那东西住在哪里”，花更多的时间完成工作。

快速开始

  1. 确保Codex主目录（通常 ~/.codex)存在。
  2. 打开 Codex工作区 从VS代码活动栏。
  3. 从每个探索标题栏中，您可以：
    • 添加文件/文件夹
    • 打开目标文件夹
    • 刷新
    • 同步
    • 打开管理器视图
  4. 打开 食品法典经理 从“核心”视图或“命令选项板”中，然后选中：
    • 历史
    • 试剂诊断
    • 受信任的目录
    • 功能标志
    • 钩子
    • 插件

主要特点

  • 专用浏览视图 Codex Manager, Sub Agents, Skills, Commands, MCP Server, Templates，以及 Codex Pet
  • 一键打开 config.toml, AGENTS.md, AGENTS.override.md、提示、技能、模板和代理定义文件
  • 直接从支持的浏览视图中添加、重命名和删除文件/文件夹
  • 外部文件夹和核心、命令、技能、模板和子代理之间的双向同步
  • 跨项目/工作区/用户/系统的统一技能列表
  • 跨项目/工作区/用户的统一子代理列表
  • 技能、子代理和MCP服务器的专用管理器视图
  • 视觉的 Orchestration Editor 在 AGENTS Manager 用于设计工作流/代理/循环图，验证它们，并生成可重用的提示
  • Codex Manager 它汇集了对话历史、代理加载链、可信目录、功能标志、钩子和插件
  • 插件可见性和启用/禁用管理集中在 Plugins 选项卡，而不是技能/子代理/MCP探索和管理器视图

重要提示： 通过解析显示对话历史记录 $CODEX_HOME/sessions/.../rollout-*.jsonl。如果Codex更改其日志格式，历史选项卡可能会停止工作。

视图

食品法典经理

从Core Explore视图，您可以访问：

  • config.toml
  • AGENTS.md
  • AGENTS.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."<id>"] 当清单和 config.toml 处于可写状态

命令

管理以下文件 ~/.codex/prompts 并将其与同步 codex-workspace.promptsFolder.

保留此“探索”视图是为了兼容。这里没有添加较新的“经理风格”功能（如技能、子代理和MCP）。

技能

在单个Explore视图中从多个存储位置管理技能：

  • Project Skills：更喜欢 project/.agents/skills；倒退到 project/.codex/skills 如果不存在
  • Workspace Skills: ~/.codex/skills
  • User Skills: ~/.agents/skills
  • System Skills: ~/.codex/skills/.system

新的项目技能总是在 project/.agents/skills.
从根目录添加时，可以选择项目/工作区/用户。
System Skills 显示为只读。
在 Skill Manager，您可以搜索、打开和切换启用/禁用。

子代理

从多个存储位置管理子代理：

  • Project Agents：更喜欢 project/.codex/agents；倒退到 project/.agents/agents 如果不存在
  • Workspace Agents: ~/.codex/agents
  • User Agents: ~/.codex/agents

新项目代理始终在中创建 project/.codex/agents.
AGENTS Manager 允许您搜索和管理启用/禁用状态。
您可以从浏览图标中识别启用/禁用状态。

编排编辑器

Orchestration Editor 可从 Orchestration 内部选项卡 AGENTS Manager.

  • 使用创建和编辑工作流图 workflow, agent，以及 loop 画布上的卡片
  • 从检查器配置代理顺序、选定的子代理、委托目的、输入、预期输出和已完成标准
  • 使用配置查看/重试循环 maxAttempts 和 acceptanceCriteria
  • 将工作流JSON文件保存在 ~/.codex/.codex-workspace/orchestrations
  • 编辑时验证缺少的必填字段、无效连接、无法访问的节点、重复的ID和周期
  • 从当前图形生成提示预览并复制它，而不需要先保存工作流

MCP服务器

MCP Server 在探索视图中保持快速开/关控制，并提供专用 MCP Manager.

在 MCP Manager，您可以：

  • 搜索
  • 添加、编辑和删除服务器定义
  • 切换启用/禁用
  • 编辑的关键字段 stdio / http 运输
  • 编辑和验证 env 键值对
  • 隐藏同伴 .env 从列表中删除条目，同时在删除父服务器时将它们一起删除

模板

管理下的模板 ~/.codex/codex-templates.支持创建文件时选择模板并与同步 codex-workspace.templatesFolder.

Codex宠物

Codex Pet 是专为动画宠物设计的基于Webview的探索工具。

  • 从以下位置加载宠物 ~/.codex/pets/<petId>
  • 允许您从标题栏中选择宠物，并保留所选宠物 petId
  • 使用空闲/拖动/单击/等待动画在“探索”视图中渲染可拖动的精灵角色
  • 可选择连接到 codex app-server 并展示 5h / 1w 刷新后的速率限制语音气泡

命令

命令 描述
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: Select Pet 打开“快速选择”以选择活动宠物 Codex Pet Explore
Codex Workspace: Connect Pet App Server 连接 Codex Pet Explore 到 codex app-server 启用该功能时
Codex Workspace: Disconnect Pet App Server 断开连接 Codex Pet Explore 从 codex app-server
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 在历史预览中包含推理消息。保留密钥名称以实现向后兼容性。
codex-workspace.pet.enabled 布尔值 false 启用 Codex Pet Explore 活动栏容器中的视图。
codex-workspace.pet.appServer.enabled 布尔值 false 为宠物视图启用标题栏连接/断开连接命令和App Server速率限制集成。
codex-workspace.pet.rateLimitRefreshMinutes 编号 5 从以下位置获取速率限制的刷新间隔（分钟） codex app-server. 0 禁用自动刷新。
codex-workspace.pet.scale 编号 1 显示宠物的比例。支持的范围为 0.5 到 2.0.
codex-workspace.pet.selectedPetId 字符串 "" 保留当前选定的宠物id

许可证

麻省理工学院

相关 MCP