Files
ponytail/docs/agent-portability.md
T
Ben YounesandClaude Opus 4.8 e01aa900f7 feat: add Gemini CLI support (#25)
* feat: add Gemini CLI support

Add a thin Gemini CLI extension adapter (closes #22). The manifest points
contextFileName at the existing AGENTS.md for always-on rules and reuses the
repo's commands/*.toml (/ponytail, /ponytail-review) and skills/, which Gemini
CLI auto-discovers — no rule text is duplicated.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* test: read manifest inside cases for a clean RED

The manifest was parsed at module scope, so reverting the adapter crashed the
whole test file at load (ENOENT) and collapsed all four cases into one
unreadable failure. Read it inside each case via a helper that asserts existence
first, so a missing or malformed manifest surfaces as clear per-case assertion
failures instead of a stack trace.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 17:50:02 +02:00

2.1 KiB

Agent Portability

Ponytail is an agent-portable skill distribution. The skills in skills/ hold the core behavior; host-specific files are adapters that make that behavior easy to load in a given agent.

Supported Adapters

Host Files Notes
Claude Code .claude-plugin/, commands/, hooks/ Full plugin install with session activation, mode tracking, commands, and statusline support.
Codex .codex-plugin/plugin.json, hooks/hooks.json, hooks/, skills/ Plugin install with the same skills plus lifecycle hooks for activation and mode tracking.
OpenCode .opencode/plugins/ponytail.mjs, .opencode/command/, hooks/, skills/ Server plugin injects the ruleset each turn via experimental.chat.system.transform and persists /ponytail switches; reuses the shared instruction builder.
Gemini CLI gemini-extension.json, AGENTS.md, commands/, skills/ Extension manifest points contextFileName at AGENTS.md for always-on rules, and reuses the existing commands/*.toml (/ponytail, /ponytail-review) and skills/, which Gemini CLI auto-discovers.
Cursor .cursor/rules/ponytail.mdc Always-on project rule.
Windsurf .windsurf/rules/ponytail.md Project rule.
Cline .clinerules/ponytail.md Project rule.
GitHub Copilot .github/copilot-instructions.md Repository instruction file.
Kiro .kiro/steering/ponytail.md Steering rule; copy globally or into a project.
Generic agents AGENTS.md or skills/*/SKILL.md Copy the compact rule file or load the skill files directly.

Adapter Rule

Keep adapters thin. When a host supports skills or hooks, point it at the existing skills/ and hooks/ files. When a host only supports project instructions, keep its copied rule text aligned with AGENTS.md.

Portable Behavior

  • skills/ponytail/SKILL.md: lazy senior dev mode
  • skills/ponytail-review/SKILL.md: over-engineering review
  • skills/ponytail-audit/SKILL.md: whole-repo over-engineering audit
  • skills/ponytail-help/SKILL.md: quick reference
  • AGENTS.md: compact always-on instruction set for agents without skill support