簡介與定位
v4.10.0 起，Ponytail 提供原生 Cursor 支援——透過 hooks.json 把 7 階「必要才寫」階梯接進 Cursor 的 hook 系統，讓 Cursor 內的 agent 只寫最少的程式碼。
🛠️ 安裝步驟
在 Ponytail 的安裝目錄執行：
node scripts/cursor-hooks.js install🔒 合併式安裝：不動你的既有 hooks
這是 Cursor 整合最重要的設計：安裝器合併進你既有的 Cursor hooks 檔案，且不動檔案裡的任何其他內容。
如果你已經有其他工具的 hooks（formatter、linter、其他 plugin），安裝 Ponytail 不會覆蓋或破壞它們——你的 hooks.json 長什麼樣、裝完就還是什麼樣，只是多了 Ponytail 的條目。
🩺 連線健全度測試
安裝後在 Cursor 中進行一次尋常的編碼任務，觀察：
- Ponytail 的精簡建議是否出現（例如提示某個抽象可以不寫）
- 既有 hooks（formatter 等）是否照常運作
/ponytail指令是否回報當前 level
⚙️ 相關設定
/ponytail default <mode>（v4.9.0 起）：讓選定的模式跨重啟保留/ponytail（單獨）：回報當前 level 而非重置PONYTAIL_SUBAGENT_MATCHER（v4.9.0 起）：控制子代理是否套用 ruleset
疑難排解
| 症狀 | 處理 |
|---|---|
| hooks 沒生效 | 確認 hooks.json 中 Ponytail 條目存在；重新載入 Cursor 視窗 |
| 其他工具 hooks 失效 | 檢查 hooks.json 是否被其他工具整檔覆寫（Ponytail 安裝器不會這麼做）；重跑 cursor-hooks.js install 補回 |
對其他平台使用者的意義
如果你在 Claude Code 與 Cursor 之間切換：兩邊的 Ponytail 行為一致（同一套 ruleset），差異只在安裝機制。v4.10.0 同時修正了 VS Code Copilot 的偵測（透過 CLAUDE_PLUGIN_ROOT fallback），不再在 VS Code Copilot 環境誤顯示 Claude Code 的 statusline 提示。
來源：v4.10.0