{"_id":"@dietrichgebert/ponytail","_rev":"4-da0ae2009bb995bb27ad959faba3784c","name":"@dietrichgebert/ponytail","dist-tags":{"latest":"4.8.4"},"versions":{"4.8.1":{"name":"@dietrichgebert/ponytail","version":"4.8.1","keywords":["opencode-plugin","opencode","ponytail","pi-package","pi","skills"],"author":{"url":"https://github.com/DietrichGebert","name":"Dietrich Gebert"},"license":"MIT","_id":"@dietrichgebert/ponytail@4.8.1","maintainers":[{"name":"dietrichgebert","email":"dietrich.gebert@gmail.com"}],"homepage":"https://github.com/DietrichGebert/ponytail","bugs":{"url":"https://github.com/DietrichGebert/ponytail/issues"},"pi":{"skills":["./skills"],"extensions":["./pi-extension/index.js"]},"dist":{"shasum":"e54b0d5434c5eea9ba93a13235521e51a3874121","tarball":"https://registry.npmjs.org/@dietrichgebert/ponytail/-/ponytail-4.8.1.tgz","fileCount":37,"integrity":"sha512-+08H6HsCyjDrInwo0fcambA5JwBEcI0EjgBw8K4E+wZMRIShdn6rzyyPVMhr+CIkThJYwQiG3OqlB7B/nwuahQ==","signatures":[{"sig":"MEUCIQDYnz1XZKPvBwE/Wr/9Sg+B5Lcj1hnd3pSABN32N6TYswIgVrkqE/+0q7hYCiEqUzB5bKWZB/5Jv/Zak0S4WxNhOm8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":948783},"main":"./.opencode/plugins/ponytail.mjs","exports":{".":"./.opencode/plugins/ponytail.mjs","./plugin":"./.opencode/plugins/ponytail.mjs"},"gitHead":"7d303b7175367e445453fb1d6ede10bbf15f73cc","scripts":{"test":"node --test tests/*.test.js && npm test --prefix pi-extension"},"_npmUser":{"name":"dietrichgebert","email":"dietrich.gebert@gmail.com"},"repository":{"url":"git+https://github.com/DietrichGebert/ponytail.git","type":"git"},"_npmVersion":"10.9.2","description":"Lazy senior dev mode for AI agents. The best code is the code you never wrote.","directories":{},"_nodeVersion":"23.6.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ponytail_4.8.1_1782263312552_0.028753199089264436","host":"s3://npm-registry-packages-npm-production"}},"4.8.2":{"name":"@dietrichgebert/ponytail","version":"4.8.2","keywords":["opencode-plugin","opencode","ponytail","pi-package","pi","skills"],"author":{"url":"https://github.com/DietrichGebert","name":"Dietrich Gebert"},"license":"MIT","_id":"@dietrichgebert/ponytail@4.8.2","maintainers":[{"name":"dietrichgebert","email":"dietrich.gebert@gmail.com"}],"homepage":"https://github.com/DietrichGebert/ponytail","bugs":{"url":"https://github.com/DietrichGebert/ponytail/issues"},"pi":{"skills":["./skills"],"extensions":["./pi-extension/index.js"]},"dist":{"shasum":"a24fb8dfecaaf9d93bb588aeb36798f55262e96e","tarball":"https://registry.npmjs.org/@dietrichgebert/ponytail/-/ponytail-4.8.2.tgz","fileCount":37,"integrity":"sha512-Ar+fUtZwTQyIRZYKGnUT/e9UGnSfRM0IYEsaE3YX1nKRO+YL3yWIhH5V64LQHyUV0J7GEWs4sKVnMWEwNZgCVw==","signatures":[{"sig":"MEUCIQCN4DK+wS3/RUp2eK9B/CXahxxozcEH9kBC4ZWDfm/wgAIgSFNwoAPD/n98CaWivxwaQVLisWSUuPiP8OV+G52HUyo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dietrichgebert%2fponytail@4.8.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":948783},"main":"./.opencode/plugins/ponytail.mjs","exports":{".":"./.opencode/plugins/ponytail.mjs","./plugin":"./.opencode/plugins/ponytail.mjs"},"gitHead":"17e277387deab5faddf417a3f554e1db4e5d08ec","scripts":{"test":"node --test tests/*.test.js && npm test --prefix pi-extension"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:818999b2-4802-4347-a31d-232fd5fd503e"}},"repository":{"url":"git+https://github.com/DietrichGebert/ponytail.git","type":"git"},"_npmVersion":"11.17.0","description":"Lazy senior dev mode for AI agents. The best code is the code you never wrote.","directories":{},"_nodeVersion":"22.22.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ponytail_4.8.2_1782264040904_0.8173316362215759","host":"s3://npm-registry-packages-npm-production"}},"4.8.3":{"name":"@dietrichgebert/ponytail","version":"4.8.3","keywords":["opencode-plugin","opencode","ponytail","pi-package","pi","skills"],"author":{"url":"https://github.com/DietrichGebert","name":"Dietrich Gebert"},"license":"MIT","_id":"@dietrichgebert/ponytail@4.8.3","maintainers":[{"name":"dietrichgebert","email":"dietrich.gebert@gmail.com"}],"homepage":"https://github.com/DietrichGebert/ponytail","bugs":{"url":"https://github.com/DietrichGebert/ponytail/issues"},"pi":{"skills":["./skills"],"extensions":["./pi-extension/index.js"]},"dist":{"shasum":"4d2827e78c97d5f21eed59fb022a61b043a9d17d","tarball":"https://registry.npmjs.org/@dietrichgebert/ponytail/-/ponytail-4.8.3.tgz","fileCount":39,"integrity":"sha512-UDhTgDqFhB2sIhohom9BwB65jgPY0effo6QXDfch9KET1KEAz5FJF6BU04Zie91rJWAH6BWUWRfjvycgRGf9Pg==","signatures":[{"sig":"MEUCIBlcFJnmpTF7gHIlRq2ItotzJKqp2VNtFzDKh6kkdaFWAiEAkVvdrXcl2Dy6nRN75wiJOEis4Yxt6EOsAi5lWE0k0/I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dietrichgebert%2fponytail@4.8.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":966885},"main":"./.opencode/plugins/ponytail.mjs","exports":{".":"./.opencode/plugins/ponytail.mjs","./plugin":"./.opencode/plugins/ponytail.mjs"},"gitHead":"025da371cd7539c3eb0ad859b08b3ca55e695f16","scripts":{"test":"node --test tests/*.test.js && npm test --prefix pi-extension"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:818999b2-4802-4347-a31d-232fd5fd503e"}},"repository":{"url":"git+https://github.com/DietrichGebert/ponytail.git","type":"git"},"_npmVersion":"11.17.0","description":"Lazy senior dev mode for AI agents. The best code is the code you never wrote.","directories":{},"_nodeVersion":"22.22.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ponytail_4.8.3_1782268373964_0.33033815151493773","host":"s3://npm-registry-packages-npm-production"}},"4.8.4":{"name":"@dietrichgebert/ponytail","version":"4.8.4","description":"Lazy senior dev mode for AI agents. The best code is the code you never wrote.","keywords":["opencode-plugin","opencode","ponytail","pi-package","pi","skills"],"license":"MIT","author":{"name":"Dietrich Gebert","url":"https://github.com/DietrichGebert"},"homepage":"https://github.com/DietrichGebert/ponytail","repository":{"type":"git","url":"git+https://github.com/DietrichGebert/ponytail.git"},"bugs":{"url":"https://github.com/DietrichGebert/ponytail/issues"},"main":"./.opencode/plugins/ponytail.mjs","exports":{".":"./.opencode/plugins/ponytail.mjs","./plugin":"./.opencode/plugins/ponytail.mjs"},"scripts":{"test":"node --test tests/*.test.js && npm test --prefix pi-extension"},"pi":{"extensions":["./pi-extension/index.js"],"skills":["./skills"]},"publishConfig":{"access":"public"},"gitHead":"bc9ee949d5f439e8b9f3bb92c6d6d3d1e6ebd324","_id":"@dietrichgebert/ponytail@4.8.4","_nodeVersion":"22.23.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-MALDTmDxKa2SJ8zKVekuOwWvo6+PvypNf5xeV2AtLO5OBtkt1U7DLWOeUbb9Th3H9lV80EkWoRI05yK0/dnekA==","shasum":"00c7c7cf1b6e47bf6f2cc810c1fd31fd31dcd13b","tarball":"https://registry.npmjs.org/@dietrichgebert/ponytail/-/ponytail-4.8.4.tgz","fileCount":44,"unpackedSize":1191632,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dietrichgebert%2fponytail@4.8.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFSRwa+f1pvi3Qy7inYDAwARo74qT4n5V79q9OHn1rqAAiEAipq2bxwFhPcwGi51wZt0Mlw/1PiKWXwb0MqhCcWEoss="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:818999b2-4802-4347-a31d-232fd5fd503e"}},"directories":{},"maintainers":[{"name":"dietrichgebert","email":"dietrich.gebert@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ponytail_4.8.4_1782710812176_0.14747178660379867"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-24T01:08:32.370Z","modified":"2026-06-29T05:26:52.649Z","4.8.1":"2026-06-24T01:08:32.737Z","4.8.2":"2026-06-24T01:20:41.141Z","4.8.3":"2026-06-24T02:32:54.168Z","4.8.4":"2026-06-29T05:26:52.344Z"},"bugs":{"url":"https://github.com/DietrichGebert/ponytail/issues"},"author":{"name":"Dietrich Gebert","url":"https://github.com/DietrichGebert"},"license":"MIT","homepage":"https://github.com/DietrichGebert/ponytail","keywords":["opencode-plugin","opencode","ponytail","pi-package","pi","skills"],"repository":{"type":"git","url":"git+https://github.com/DietrichGebert/ponytail.git"},"description":"Lazy senior dev mode for AI agents. The best code is the code you never wrote.","maintainers":[{"name":"dietrichgebert","email":"dietrich.gebert@gmail.com"}],"readme":"<p align=\"center\">\n  <picture>\n    <source media=\"(prefers-color-scheme: dark)\" srcset=\"assets/logo-dark.png\">\n    <img src=\"assets/logo.png\" width=\"220\" alt=\"Ponytail, the lazy senior dev\">\n  </picture>\n</p>\n\n<h1 align=\"center\">Ponytail</h1>\n\n<p align=\"center\">\n  <em>He says nothing. He writes one line. It works.</em>\n</p>\n\n<p align=\"center\">\n  <img src=\"https://img.shields.io/github/stars/DietrichGebert/ponytail?style=flat-square&color=111111&label=stars\" alt=\"Stars\">\n  <img src=\"https://img.shields.io/github/v/release/DietrichGebert/ponytail?style=flat-square&color=111111&label=release\" alt=\"Release\">\n  <img src=\"https://img.shields.io/npm/v/@dietrichgebert/ponytail?style=flat-square&color=111111&label=npm\" alt=\"npm\">\n  <img src=\"https://img.shields.io/badge/works%20with-16%20agents-111111?style=flat-square\" alt=\"Works with 16 agents\">\n  <img src=\"https://img.shields.io/badge/license-MIT-111111?style=flat-square\" alt=\"MIT license\">\n</p>\n\n<p align=\"center\">\n  <a href=\"https://trendshift.io/repositories/50668\" target=\"_blank\" rel=\"noopener noreferrer\"><img src=\"https://trendshift.io/api/badge/trendshift/repositories/50668/daily\" alt=\"DietrichGebert/ponytail | Trendshift\" width=\"250\" height=\"55\"/></a>\n  <a href=\"https://trendshift.io/repositories/50668\" target=\"_blank\" rel=\"noopener noreferrer\"><img src=\"https://trendshift.io/api/badge/trendshift/repositories/50668/weekly\" alt=\"DietrichGebert/ponytail | Trendshift\" width=\"250\" height=\"55\"/></a>\n</p>\n\n<p align=\"center\">\n  <strong>~54% less code (up to 94%) &middot; ~20% cheaper &middot; ~27% faster &middot; 100% safe</strong><br>\n  <sub>Measured on real Claude Code sessions editing a real open-source repo (FastAPI + React), against the same agent with no skill. ~54% is the mean across 12 feature tasks (Haiku 4.5, n=4); it reaches 94% where an agent over-builds (a date picker) and is near zero where the code is already minimal. ponytail keeps every safety guard while a bare \"write one-liners\" prompt drops one. (The earlier single-shot benchmark reported 80-94% as a flat figure; against a fair agentic baseline that is the per-task ceiling, not the average.) <a href=\"benchmarks/results/2026-06-18-agentic.md\">Full writeup</a> &middot; <a href=\"benchmarks/\">reproduce it</a>.</sub>\n</p>\n\n<p align=\"center\">\n  <sub><a href=\"README.es.md\">Español</a> &middot; <a href=\"README.ko.md\">한국어</a></sub>\n</p>\n\n---\n\n<p align=\"center\">\n  <a href=\"https://ponytail.dev/soon\"><img src=\"assets/waitlist-banner.png\" alt=\"Something's coming, join the waitlist\" width=\"760\"></a>\n</p>\n\nYou know him. Long ponytail. Oval glasses. Has been at the company longer than the version control. You show him fifty lines; he looks at them, says nothing, and replaces them with one.\n\nPonytail puts him inside your AI agent.\n\n## Before / after\n\nYou ask for a date picker. Your agent installs flatpickr, writes a wrapper component, adds a stylesheet, and starts a discussion about timezones.\n\nWith ponytail:\n\n```html\n<!-- ponytail: browser has one -->\n<input type=\"date\">\n```\n\nMore survivors in [examples/](examples/).\n\n## Numbers\n\nThe honest measurement is a real agent doing real work: a headless Claude Code session editing [tiangolo's full-stack-fastapi-template](https://github.com/fastapi/full-stack-fastapi-template) (a real FastAPI + React repo), scored on the `git diff` it leaves behind. Twelve feature tickets, the same agent with and without the skill, n=4, Haiku 4.5.\n\n<p align=\"center\">\n  <img src=\"assets/benchmark-agentic.svg\" width=\"860\" alt=\"Each arm as a percent of the no-skill baseline across LOC, tokens, cost and time (Haiku 4.5). ponytail is lowest on every metric (LOC 46%, tokens 78%, cost 80%, time 73%); caveman rises above 100% on tokens, cost and time; yagni-oneliner LOC 67%. Safety, separate adversarial tier: baseline, caveman and ponytail 100%, yagni-oneliner 95%.\">\n</p>\n\n| vs no-skill baseline | LOC | tokens | cost | time | safe |\n|---|--:|--:|--:|--:|--:|\n| **ponytail** | **-54%** | **-22%** | **-20%** | **-27%** | **100%** |\n| caveman (terse-prose control) | -20% | +7% | +3% | +2% | 100% |\n| \"YAGNI + one-liners\" prompt | -33% | -14% | -21% | -30% | 95% |\n\nponytail is the only arm that cuts every metric, and the only one that stays fully safe while doing it. The cut is biggest where there is a real over-build trap (date picker 404 to 23 lines, color picker 287 to 23, because it reaches for a native `<input>` instead of a component) and near zero on code that is already minimal. Full method, per-task tables, and limitations: [benchmarks/results/2026-06-18-agentic.md](benchmarks/results/2026-06-18-agentic.md).\n\n<details>\n<summary><strong>Older single-shot numbers (isolated generation)</strong></summary>\n\nFive everyday tasks, three models, three arms (no skill, [caveman](https://github.com/JuliusBrussee/caveman), ponytail), ten runs, median reported. One prompt, one completion, counting lines of the answer:\n\n<p align=\"center\">\n  <img src=\"assets/benchmark-3model.svg\" width=\"860\" alt=\"Median lines of code per arm across Haiku, Sonnet and Opus\">\n</p>\n\nThis showed **80-94% less code**. [#126](https://github.com/DietrichGebert/ponytail/issues/126) fairly pointed out that the bare-model baseline pads its answer with prose and options, so that gap is partly a conversational-baseline artifact. The agentic numbers above are the corrected, defensible version. Reproduce the single-shot run with `npx promptfoo eval -c benchmarks/promptfooconfig.yaml`.\n\n</details>\n\n**The rule was never \"fewest tokens.\"** It is: write only what the task needs, and never cut validation, error handling, security, or accessibility. The code ends up small because it is necessary, not golfed. Lower cost and latency are a side effect on the models that follow the ladder; a terse reasoning model that spends thinking tokens deliberating the rungs can go the other way (on GPT-5.5 it does).\n\n## How it works\n\nBefore writing code, the agent stops at the first rung that holds:\n\n```\n1. Does this need to exist?   → no: skip it (YAGNI)\n2. Already in this codebase?  → reuse it, don't rewrite\n3. Stdlib does it?            → use it\n4. Native platform feature?   → use it\n5. Installed dependency?      → use it\n6. One line?                  → one line\n7. Only then: the minimum that works\n```\n\nThe ladder runs *after* it understands the problem, not instead of it: it reads the code the change touches and traces the real flow before picking a rung. Lazy about the solution, never about reading.\n\nLazy, not negligent: trust-boundary validation, data-loss handling, security, and accessibility are never on the chopping block.\n\n## Install\n\nThe most effort ponytail will ever ask of you:\n\nThe Claude Code and Codex plugins run two tiny Node.js lifecycle hooks, so `node` needs to be on your PATH (note for Nix/nvm users: it must be on the non-interactive shell's PATH). If it isn't, the skills still work, the always-on activation just stays quiet instead of erroring on every prompt.\n\n### Claude Code\n\n```\n/plugin marketplace add DietrichGebert/ponytail\n```\n```\n/plugin install ponytail@ponytail\n```\n(You have to send two separate prompts for the install to work) \n\nThe desktop app has no `/plugin` command. Install it from the UI instead: Customize, the + by personal plugins, Create plugin and add marketplace, Add from repository, then enter the repo URL (thanks @NiklasDHahn, #98).\n\n### Codex\n\n```bash\ncodex plugin marketplace add DietrichGebert/ponytail\ncodex\n```\n\nOpen `/plugins`, select the Ponytail marketplace, and install Ponytail. Then\nopen `/hooks`, review and trust its two lifecycle hooks, and start a new thread.\n\nThis same install also covers the Codex desktop app: restart the app after installing and it picks up the plugin.\n\n### GitHub Copilot CLI\n\n```bash\ncopilot plugin marketplace add DietrichGebert/ponytail\ncopilot plugin install ponytail@ponytail\n```\n\nIn an interactive Copilot CLI session, use the slash equivalents:\n\n```\n/plugin marketplace add DietrichGebert/ponytail\n/plugin install ponytail@ponytail\n```\n\nCopilot CLI namespaces plugin commands by plugin name. For example:\n\n```text\n/ponytail:ponytail ultra\n/ponytail:ponytail-review\n```\n\n### Pi agent harness\n\n```\npi install git:github.com/DietrichGebert/ponytail\n```\n\n### OpenCode\n\nAdd to `opencode.json`:\n\n```json\n{ \"plugin\": [\"@dietrichgebert/ponytail\"] }\n```\n\nRun from a checkout instead (the plugin reuses `hooks/` and `skills/`):\n\n```json\n{ \"plugin\": [\"./.opencode/plugins/ponytail.mjs\"] }\n```\n\nInjects the ruleset every turn at the active level; adds the `/ponytail` commands (see [Commands](#commands)). OpenCode also auto-loads this repo's `AGENTS.md`, so the rules hold even without the plugin. The plugin adds the `lite/full/ultra/off` levels.\n\nThe `./` path resolves against your project's `opencode.json`; to share one checkout across projects, point it at the absolute path of the `.mjs` instead (it finds its `hooks/` and `skills/` relative to its own file).\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/DietrichGebert/ponytail\n```\n\nLoads the ruleset as always-on context every session and registers the `/ponytail` commands; the `skills/` ship too, activated when a task needs them.\nThe Gemini adapter intentionally does not ship a root `hooks/hooks.json`: Gemini auto-loads that path, while Ponytail's lifecycle hooks use Claude/Codex event names.\n\n### Antigravity CLI\n\nGoogle is renaming Gemini CLI to Antigravity CLI (the `agy` binary); the same extension installs there:\n\n```bash\nagy plugin install https://github.com/DietrichGebert/ponytail\n```\n\nIt reuses this repo's `gemini-extension.json`. One difference: Antigravity converts the `/ponytail` commands into skills, so you type them into the chat (e.g. `/ponytail-review` as a message) instead of picking them from a slash menu. Until the migration completes (around June 18, 2026), `gemini extensions install` still works too. To run it as an always-on rule instead, drop the ruleset into `.agents/rules/`.\n\n### Hermes Agent\n\n```bash\nhermes plugins install DietrichGebert/ponytail --enable\n```\n\nRestart Hermes after installing. The plugin injects the active Ponytail mode before each LLM turn, registers the bundled skills as `ponytail:<skill>`, and adds `/ponytail`, `/ponytail-review`, `/ponytail-audit`, `/ponytail-debt`, `/ponytail-gain`, and `/ponytail-help`. In shared gateways, restrict `/ponytail` to trusted users with Hermes slash-command access controls; runtime mode is process-local.\n\n### CodeWhale\n\nReads `AGENTS.md` from the project root, zero setup. Copy [`AGENTS.md`](AGENTS.md) to your project, or run `codewhale` from a checkout of this repo. That's it.\n\n### Swival\n\nStage the collection in your library first, then add the skills you want:\n\n```bash\nswival skills add --global https://github.com/DietrichGebert/ponytail  # stage into ~/.config/swival/library\nswival skills add ponytail                                             # install the collection into this project\nswival skills add --global ponytail                                    # or activate it in every project\n```\n\nSwival also reads `AGENTS.md` from the project root and `~/.config/swival/AGENTS.md` globally, the instruction-only fallback.\n\nOn the command line, use a `$` prefix to explicitly activate a skill. For example: `$ponytail-review`.\n\n### Devin CLI\n\n```bash\ndevin plugins install DietrichGebert/ponytail\n```\n\nInstalls ponytail as a Devin plugin; skills are available as `/ponytail:ponytail`, `/ponytail:ponytail-review`, and so on.\n\n### OpenClaw\n\n```bash\nclawhub install ponytail\n```\n\nInstalls ponytail as an OpenClaw skill from ClawHub; the review, audit, debt, gain, and help skills install the same way (`clawhub install ponytail-review`, and so on). OpenClaw applies it on coding tasks and also exposes it as a `/ponytail` command. Without ClawHub, copy [`.openclaw/skills/ponytail`](.openclaw/skills/) into `~/.openclaw/skills/`.\n\nThat was it. He'd be proud. He won't say it.\n\nActive every session, with a handful of commands (see [Commands](#commands)). `/ponytail ultra` exists for when the codebase has wronged you personally. Startup and mode-change text shows the current mode.\n\nSet the level for every new session with the `PONYTAIL_DEFAULT_MODE` env var (`lite`/`full`/`ultra`/`off`), or a `defaultMode` field in `~/.config/ponytail/config.json` (`%APPDATA%\\ponytail\\config.json` on Windows). The default is `full`.\n\nCursor, Windsurf, Cline, GitHub Copilot (editor), Aider, Kiro, Zed, CodeWhale, Swival: copy the matching rules file from this repo ([`.cursor/rules/`](.cursor/rules/), [`.windsurf/rules/`](.windsurf/rules/), [`.clinerules/`](.clinerules/), [`.github/copilot-instructions.md`](.github/copilot-instructions.md), [`AGENTS.md`](AGENTS.md), [`.kiro/steering/`](.kiro/steering/)).\n\nKiro: copy `.kiro/steering/ponytail.md` to `~/.kiro/steering/` (global) or `.kiro/steering/` in your project.\n\nGitHub Copilot CLI fallback (instruction-only mode): it reads `AGENTS.md` and `.github/copilot-instructions.md` in a project, or copy the rules into `~/.copilot/copilot-instructions.md` to run ponytail in every project. This path keeps always-on guidance, but does not add plugin mode switches or hooks.\n\nVS Code with the Codex extension reads `AGENTS.md`, which this repo ships, so it works from the repo root with no setup (`~/.codex/AGENTS.md` makes Codex global).\n\nWhich files map to which agent: [Agent portability](docs/agent-portability.md).\n\n### Uninstall\n\n| Host | Command |\n|------|---------|\n| Claude Code | `/plugin remove ponytail` |\n| Codex | `codex plugin remove ponytail` |\n| Devin CLI | `devin plugins remove ponytail` |\n| Pi agent | `pi uninstall ponytail` |\n| Cursor / Windsurf / Cline / etc. | Delete the copied rule file |\n\nThese remove the plugin's own files. They leave behind a small amount of state ponytail writes outside the plugin folder: the mode flag, `~/.config/ponytail/config.json`, and (if you accepted the setup nudge) a `statusLine` entry in `~/.claude/settings.json`. Run `node scripts/uninstall.js` to clean those up too. **Run it before the host remove command above** — the script is itself a plugin file, so removing the plugin first deletes it (or run it from a separate clone of this repo). It only removes the statusLine entry if it points at ponytail's own script, so a statusline you set up yourself is left untouched.\n\n## Commands\n\n| Command | What it does |\n|---------|--------------|\n| `/ponytail [lite \\| full \\| ultra \\| off]` | Set the intensity, or turn it off. No argument reports the current level. |\n| `/ponytail-review` | Review the current diff for over-engineering, hands back a delete-list. |\n| `/ponytail-audit` | Audit the whole repo for over-engineering, not just the diff. |\n| `/ponytail-debt` | Harvest the `ponytail:` shortcuts you've deferred into a ledger, so \"later\" doesn't become \"never\". |\n| `/ponytail-gain` | Show the measured impact scoreboard (less code, less cost, more speed) from the benchmark. |\n| `/ponytail-help` | Quick reference for the commands above. |\n\nCommands need a skill-capable host (Claude Code, Codex, Devin CLI, OpenCode, Gemini, pi, Swival, Hermes Agent). In Codex they're skills, invoke with `@` (`@ponytail-review`). The instruction-only adapters (Cursor, Windsurf, Cline, Copilot, Kiro, Antigravity) load the always-on ruleset without the commands.\n\n## Development\n\nWhen changing the compact rule text, keep the agent copies aligned:\n\n```bash\nnode scripts/check-rule-copies.js\nnpm test\n```\n\nThe OpenClaw skill package (`.openclaw/skills/`) is generated from `skills/`; rerun `node scripts/build-openclaw-skills.js` after changing a skill, the test suite fails if it is stale. To publish the skills to ClawHub, run `clawhub login` once, then `node scripts/publish-openclaw-skills.js` (it publishes all six at the `package.json` version; pass `--dry-run` to preview).\n\nThe correctness benchmark spawns Python for email and CSV checks; `python3` is tried before `python`. CSV checks need `pandas` installed locally.\n\n## FAQ\n\n**Does it need a config file?**\nNo. An optional `~/.config/ponytail/config.json` or `PONYTAIL_DEFAULT_MODE` env var can set the default level, but nothing is required.\n\n**What if I really need the 120-line cache class?**\nYou don't. Insist anyway and he'll build it. Slowly. Correctly. While looking at you.\n\n**Does it scale?**\nThe code you never wrote scales infinitely. Zero bugs, zero CVEs, 100% uptime since forever.\n\n**Why \"ponytail\"?**\nYou know exactly why.\n\n## Sponsors\n\n<p align=\"center\">\n  <a href=\"https://greenpt.com/\">\n    <picture>\n      <source media=\"(prefers-color-scheme: dark)\" srcset=\"assets/logo-greenpt-dark.svg\">\n      <img src=\"assets/logo-greenpt.svg\" width=\"260\" alt=\"GreenPT\">\n    </picture>\n  </a>\n</p>\n\n## License\n\n[MIT](LICENSE). The shortest license that works.\n\n## Star History\n\n<a href=\"https://www.star-history.com/dietrichgebert/ponytail#history\">\n <picture>\n   <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/chart?repos=DietrichGebert/ponytail&type=Date&theme=dark\" />\n   <source media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/chart?repos=DietrichGebert/ponytail&type=Date\" />\n   <img alt=\"Star History Chart\" src=\"https://api.star-history.com/chart?repos=DietrichGebert/ponytail&type=Date\" />\n </picture>\n</a>\n","readmeFilename":"README.md"}