# Ponytail

Source: https://trendhub.net/skills/dietrichgebert-ponytail
Repository: https://github.com/DietrichGebert/ponytail
Author: DietrichGebert (https://github.com/DietrichGebert)
License: MIT
GitHub stars: 192,263

Ponytail is DietrichGebert's always-on skill that makes a coding agent behave like a reluctant senior developer: it reads the affected code, then reaches for existing helpers, the standard library or a one-liner before writing anything new. It never cuts validation, security or accessibility, and adds review, audit and shortcut-ledger commands. It suits developers tired of agents producing bloated diffs.

## What problems it solves

- **Agents build what already exists**: Before writing code the agent checks, in order, whether the feature is needed, already in the repo, in the standard library or an installed dependency.
- **Small diffs that skip safety checks**: The rules forbid cutting trust-boundary validation, data-loss handling, security or accessibility, and require a small test for risky logic.
- **Deferred shortcuts get forgotten**: Known limits are marked with shortcut: comments that a debt command later gathers into one ledger.
- **Reviews that only read the diff**: The review command follows callers and data flow outside the diff and explains each finding in plain language.

## Install

### Claude Code

Run the two lines as separate prompts; Ponytail is then active every session.

```
/plugin marketplace add DietrichGebert/ponytail
/plugin install ponytail@ponytail
```

### Codex

Afterwards trust the two lifecycle hooks in /hooks and open a new thread.

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

On Claude Code and Codex use the plugin route, which also brings the commands; on Codex you then trust its two lifecycle hooks in /hooks and start a new thread. Agents that only read a rules file can take the compact AGENTS.md instead, but they get the always-on rules without the commands.

## Skills

Skill names are shown as /name. Depending on the agent, a skill runs when it is relevant or when you call it by name; plugin installs may add a prefix.

- `/ponytail-audit`: Maps the whole repo's entry points and data flows, then ranks up to 20 findings and says what to fix first. (https://trendhub.net/skills/dietrichgebert-ponytail/ponytail-audit.markdown)
- `/ponytail-debt`: Collects every shortcut: comment into a ledger of limits and upgrade triggers, tagging ones with no trigger. (https://github.com/DietrichGebert/ponytail/tree/main/skills/ponytail-debt)
- `/ponytail-gain`: Prints the published benchmark scoreboard for code, tokens, cost and time, without claiming savings for your repo. (https://github.com/DietrichGebert/ponytail/tree/main/skills/ponytail-gain)
- `/ponytail-review`: Reviews a diff and the code around it for bugs, security, load, missing tests, speed and excess, in plain English. (https://trendhub.net/skills/dietrichgebert-ponytail/ponytail-review.markdown)
- `/ponytail`: Makes the smallest complete change, preferring existing code, stdlib and installed packages, and ends each reply with skips and risks. (https://trendhub.net/skills/dietrichgebert-ponytail/ponytail.markdown)

## Questions

### Is Ponytail free?

Yes. It is released under the MIT license.

### Which agents can run the commands?

Skill-capable hosts such as Claude Code, Codex, Devin CLI, OpenCode, Gemini and Antigravity CLI get the commands; Cursor rules, Windsurf, Cline, Copilot and Kiro load only the always-on rules.

### Does it need configuration?

Nothing is required. The default level is full, and you can change it with the PONYTAIL_DEFAULT_MODE environment variable or a config.json file in ~/.config/ponytail/.

### How do I tell a genuine copy?

The README says to install only from the DietrichGebert/ponytail GitHub repo or the @dietrichgebert/ponytail npm package, and that real releases never ship .exe or .dll files.

## Before you install

The skills are instructions: the main one edits code as normal, while review, audit and debt read files and run searches such as git grep, and debt writes a ledger file only if you ask. The Claude Code and Codex plugins add lifecycle hooks, and in Claude Code a band above the prompt with a local board that keeps session cost and token data in ~/.config/ponytail/band/.
