Ponytail + Codex CLI¶

Ponytail 是面向编码 Agent 的提示词与技能插件，帮助 Codex 优先复用现有代码，以最少的必要改动完成任务。

SessionStart、UserPromptSubmit、SubagentStart 三个 hooks 均为 Trusted；默认使用 full。

1. 安装与启用¶

在普通 Shell 或 Herdr 的 Shell 面板中检查环境：

codex --version
node --version
command -v node

Codex 需支持 plugin 子命令。Ponytail 的生命周期 hooks 使用 Node.js，node 必须位于非交互 Shell 的 PATH 中；使用 nvm 等环境管理器时尤其需要检查。安装要求

在 Shell 中依次执行：

codex plugin marketplace add DietrichGebert/ponytail
codex plugin add ponytail@ponytail
codex

进入 Codex 后，在 Codex 输入框中输入：

/hooks

审阅并信任 Ponytail 的 hooks，以 /hooks 实际列表为准，然后创建新会话。

启用后，直接向 Codex 描述编码任务。需要主动调用功能时，在 Codex 输入框中使用插件命名空间：

在 Codex 输入框中选择一项：

$ponytail:ponytail lite
$ponytail:ponytail full
$ponytail:ponytail ultra
$ponytail:ponytail off

切换后观察回复确认。普通的 lite/full/ultra/off 切换不修改新会话默认值。模式定义、切换实现

不创建配置文件也能使用，默认模式为 full。需要明确设置新会话默认模式时，在 Codex 输入框中执行：

$ponytail:ponytail default full

该命令只写默认配置，新会话采用，不切换当前模式。默认模式设置实现

也可用 PONYTAIL_DEFAULT_MODE 环境变量，例如在 Shell 中为这次启动指定：

PONYTAIL_DEFAULT_MODE=full codex

也可在 ~/.config/ponytail/config.json 中配置新会话的默认模式：

{
  "defaultMode": "full"
}

使用默认的 full 时无需创建该文件。环境变量优先于配置文件；如果设置了 XDG_CONFIG_HOME，配置文件位于该目录的 ponytail/config.json。默认配置说明

Herdr 的多个标签和面板只要使用同一用户、同一个 CODEX_HOME，就共用该用户的 Codex 插件配置，无需在每个标签重复安装。安装和信任完成后，在各项目的新 Codex 会话中使用。每个项目继续保留自己的 AGENTS.md。

多标签并行建议保持统一模式，当前插件的模式状态并非按会话完全隔离。状态存储实现

现象	检查或处理
安装后没有自动启用	在 Codex 中检查 `/hooks` 的信任状态，再创建新会话
输入 `/ponytail-review` 无效	改用 Codex 的 `$ponytail:ponytail-review` 技能调用
找不到费用统计 band / board	这是 Claude Code 的配套界面，不是 Codex CLI 功能

临时关闭 Ponytail，在 Codex 输入框执行 $ponytail:ponytail off。需要禁用插件时，在 Codex 中打开 /plugins，选中 Ponytail 后按空格切换启用状态。

卸载插件，在 Shell 中执行：

codex plugin remove ponytail@ponytail

不再需要该插件市场时，再移除市场：

codex plugin marketplace remove ponytail

卸载后创建新 Codex 会话，避免沿用已加载的技能上下文。插件管理命令可用 codex plugin --help 查看。