ponytail
- Type
- Plugin
- Scanned
- Nov 13, 2026
- Version
- 96608e078b2d
- Files read
- 161
Ponytail is a plugin and skill set for AI coding agents that guides them to write minimal code, review changes, and track session costs and code reuse in a local dashboard. It sends no data off your machine by default and shows strong security practices, with only minor hardening issues in Qoder hook path quoting, Windows browser launching, and Hermes gateway access checks.
What it can reach
- Files
- Reads source files in the current project to map existing function and class names, reads Claude Code transcripts in ~/.claude/projects/ for session titles and metrics, writes mode and settings files under ~/.claude/, ~/.cursor/, ~/.qoder/, ~/.codebuddy/, and ~/.config/, and saves task metrics and board.html in ~/.config/ponytail/band/.
- Shell commands
- Runs Node.js lifecycle hooks on session start and prompt submission, calls git and grep to index code definitions and read session metadata, and launches the system file opener to view the local task board.
- Network
- Makes no network requests by default; in Claude Code, if you configure an optional webhook URL, it posts session summary metrics (and optionally task names) as JSON after each turn.
- Secrets
- In Claude Code, reads an optional webhook Bearer token from the system keychain when configured and sends it only over HTTPS or to localhost.
- Browser
- Opens the local ~/.config/ponytail/band/board.html dashboard in your default web browser when you click the Board button in Claude Code.
Findings
-
LowUnescaped plugin root placeholder in Qoder hook command
Unlike the Claude Code and Copilot hook files, which read the plugin folder path inside Node.js so the shell never parses it, the Qoder hook configuration inserts ${QODER_PLUGIN_ROOT} directly into a double-quoted shell command. If Qoder substitutes this placeholder as text before invoking the shell and the plugin is installed in a folder path containing quotes, backticks, or $(), the shell could execute unintended commands on every prompt.
Fix: Read process.env.QODER_PLUGIN_ROOT inside a node -e script (matching hooks/claude-codex-hooks.json) instead of interpolating ${QODER_PLUGIN_ROOT} into the shell command string.
-
LowHermes gateway slash-command access check fails open if internal API changes
When rewriting /ponytail-* commands received from a Hermes chat gateway, the plugin checks user permissions by looking up a private gateway._check_slash_access method and event.source. While exceptions in that check deny access, a missing _check_slash_access attribute (for example after a Hermes update) or missing event.source returns False and allows the command rewrite instead of denying it.
Fix: Return True (access denied) whenever gateway is present but _check_slash_access or event.source is None so that internal Hermes API changes fail closed.
-
LowWindows board launcher passes file path through cmd.exe
Clicking the Board button on Windows opens board.html by running cmd /c start with a path built from USERPROFILE or XDG_CONFIG_HOME. If that path contains cmd.exe operators such as & without spaces (for example C:\Users\R&D), cmd.exe can split the command instead of treating the path purely as a file argument.
Fix: Open the HTML file on Windows without invoking cmd.exe, such as by running rundll32 url.dll,FileProtocolHandler with the file path.
