prompt-enhancer-cli 1.5.0__tar.gz

prompt_enhancer_cli-1.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hongphuc5497
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

prompt_enhancer_cli-1.5.0/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: prompt-enhancer-cli
+Version: 1.5.0
+Summary: Reverse-engineered from Auggie's Ctrl+P — transforms rough ideas into production system prompts for AI coding agents
+Author-email: hongphuc5497 <hongphuc.dthp@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/hongphuc5497/prompt-enhancer
+Project-URL: Repository, https://github.com/hongphuc5497/prompt-enhancer.git
+Keywords: prompt-engineering,ai,llm,claude-code,codex,cursor,auggie,system-prompt,agent
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# <img src="docs/logo.svg" alt="pe" height="60"> Prompt Enhancer
+
+<p align="center">
+  <strong>Generate reusable 7-section agent system prompts from rough persona ideas.</strong><br>
+  <sub>With optional install helpers, benchmarking, and local history.</sub>
+</p>
+
+<p align="center">
+  <a href="https://github.com/hongphuc5497/prompt-enhancer/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"></a>
+  <a href="https://github.com/hongphuc5497/prompt-enhancer/releases"><img src="https://img.shields.io/badge/version-1.5.0-blue" alt="Version"></a>
+  <a href="https://github.com/hongphuc5497/prompt-enhancer"><img src="https://img.shields.io/badge/python-3.12+-blue" alt="Python 3.12+"></a>
+  <a href="https://github.com/hongphuc5497/prompt-enhancer"><img src="https://img.shields.io/badge/dependencies-0-lightgrey" alt="Zero dependencies"></a>
+</p>
+
+Two CLI modes for two use cases:
+- **`pe persona`** — Generate persistent 7-section system prompts (for saving, sharing, installing into agent configs)
+- **`pe enhance-task`** — Inline task refinement with workspace context (like Auggie's Ctrl+P)
+
+The CLI is `pe` (short) and `prompt-enhancer` (long). Both work identically.
+
+## Install
+
+```bash
+pip install prompt-enhancer-cli
+```
+
+Or install directly from source:
+
+```bash
+pip install git+https://github.com/hongphuc5497/prompt-enhancer.git
+```
+
+> The PyPI distribution is `prompt-enhancer-cli` (the bare name `prompt-enhancer`
+> was already taken). The command is still `pe` (or `prompt-enhancer`) — only
+> the install line changes.
+
+Set your API key:
+```bash
+echo "LLM_API_KEY=*** > ~/.prompt-enhancer.env
+```
+
+Config (`~/.prompt-enhancer.env`):
+```env
+LLM_API_KEY=***i...ps://api.deepseek.com
+LLM_MODEL=deepseek-chat
+```
+
+Any OpenAI-compatible API works: DeepSeek, OpenAI, OpenRouter, Together, Groq, etc.
+
+## Quick start
+
+```bash
+# Generate a 7-section system prompt
+pe persona "a senior Rust developer who prefers functional programming"
+
+# Inline task refinement (Auggie Ctrl+P style)
+pe enhance-task "fix the login bug in the auth module"
+
+# Safe install into agent config (creates backup if exists)
+pe install "a security reviewer" --agent claude
+
+# Benchmark before vs after
+pe benchmark --enhance "a Go backend dev"
+
+# Health check
+pe doctor
+
+# View analytics
+pe store stats
+```
+
+## Two modes
+
+| Command | Purpose | Output |
+|---------|---------|--------|
+| `pe persona` | Generate persistent system prompt | 7 sections: ROLE, CONTEXT, RULES, TECH, FORMAT, PITFALLS, EXAMPLES |
+| `pe enhance-task` | Inline task refinement | 3-5 sentence focused task prompt with workspace context |
+
+Both modes auto-discover workspace context (`AGENTS.md`, `CLAUDE.md`, `package.json`, `Cargo.toml`, etc.) from the current project.
+
+## What `pe persona` generates
+
+1. **ROLE** — Specific, well-scoped identity
+2. **CONTEXT** — Project specs from workspace files
+3. **BEHAVIORAL RULES** — Communication style, decision-making
+4. **TECHNICAL GUIDELINES** — Testing, code style, architecture
+5. **OUTPUT FORMAT** — Code blocks, explanation style
+6. **PITFALLS / GUARDRAILS** — Anti-patterns, security warnings
+7. **EXAMPLES** — 1-2 realistic interactions
+
+Plus a "pro tip".
+
+## Benchmark
+
+7-dimension rubric scoring (SurePrompts): Role Clarity, Context Sufficiency, Instruction Specificity, Format Structure, Example Quality, Constraint Tightness, Output Validation. Each scored 1–5, max 35.
+
+```bash
+pe benchmark --before raw.txt --after enhanced.md
+pe benchmark --enhance "a Go backend dev"   # all-in-one
+```
+
+| Score | Verdict |
+|-------|---------|
+| 28-35 | Production-ready |
+| 21-27 | Working draft |
+| 14-20 | Needs major revision |
+| 7-13 | Rewrite from scratch |
+
+## Comparison with Auggie
+
+Both this tool and Auggie's native `--enhance-prompt` have their strengths:
+
+| | `pe persona` | `pe enhance-task` | Auggie `--enhance-prompt` |
+|---|---|---|---|
+| **Best for** | Persistent system prompts | Inline task refinement | Inline task refinement |
+| **Output** | 7-section document | 3-5 sentences | 1-3 sentences |
+| **Workspace aware** | Yes (auto-discovers context) | Yes | Yes (native) |
+| **Installable** | Yes (`pe install`) | No | No |
+| **Reusable** | Save, share, version | Session-scoped | Session-scoped |
+| **Benchmark** | Built-in rubric | No | No |
+| **Analytics** | Auto-store | Auto-store | No |
+
+They are complementary tools, not competitors.
+
+## Profiles
+
+| Profile | Focus |
+|---------|-------|
+| `senior-dev` | Technical depth, testing, edge cases |
+| `architect` | System design, trade-offs, scalability |
+| `reviewer` | Security, performance, code smells |
+| `sre` | Observability, reliability, incident response |
+| `product` | User experience, feature prioritization |
+| `mentor` | Teaching, onboarding, pair-programming |
+
+## Agent integration
+
+```bash
+pe install "a Rust dev..." --agent claude    # → CLAUDE.md
+pe install "..." --agent codex               # → .codex/system.md
+pe install "..." --agent cursor              # → .cursorrules
+pe install "..." --agent all                 # → all compatible configs
+```
+
+Safe by default — creates `.bak` backup of existing files. Use `--force` to skip backup, `--dry-run` to preview.
+
+| Agent | Config file | Auto-loaded? |
+|-------|------------|:---:|
+| **Claude Code** | `CLAUDE.md` | ✅ |
+| **Codex** | `.codex/system.md` | ✅ |
+| **OpenCode** | `AGENTS.md` | ✅ |
+| **Cursor** | `.cursorrules` | ✅ |
+| **Auggie** | `AGENTS.md` | ✅ |
+| **Copilot** | `.github/copilot-instructions.md` | ✅ |
+| **Aider** | `.aider-persona.md` | `--system-prompt` flag |
+
+## Analytics store
+
+Every enhancement is auto-logged to `~/.prompt-enhancer/store.jsonl`:
+
+```bash
+pe store list              # Recent enhancements
+pe store stats             # Analytics
+pe store search "rust"     # Search by keyword
+pe store show <id>         # Detailed view
+pe store delete <id>       # Remove a record
+pe store clear             # Wipe all data
+pe store export --format csv  # Export for analysis
+```
+
+First run shows a privacy notice. Use `--no-store` to opt out.
+
+## Demo
+
+See [docs/demo.tape](docs/demo.tape) for the VHS terminal recording script.
+
+## Config
+
+```env
+# ~/.prompt-enhancer.env
+LLM_API_KEY=***i...ps://api.deepseek.com   # Default
+LLM_MODEL=deepseek-chat                    # Default
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). PRs welcome.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

prompt_enhancer_cli-1.5.0/README.md

@@ -0,0 +1,191 @@
+# <img src="docs/logo.svg" alt="pe" height="60"> Prompt Enhancer
+
+<p align="center">
+  <strong>Generate reusable 7-section agent system prompts from rough persona ideas.</strong><br>
+  <sub>With optional install helpers, benchmarking, and local history.</sub>
+</p>
+
+<p align="center">
+  <a href="https://github.com/hongphuc5497/prompt-enhancer/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"></a>
+  <a href="https://github.com/hongphuc5497/prompt-enhancer/releases"><img src="https://img.shields.io/badge/version-1.5.0-blue" alt="Version"></a>
+  <a href="https://github.com/hongphuc5497/prompt-enhancer"><img src="https://img.shields.io/badge/python-3.12+-blue" alt="Python 3.12+"></a>
+  <a href="https://github.com/hongphuc5497/prompt-enhancer"><img src="https://img.shields.io/badge/dependencies-0-lightgrey" alt="Zero dependencies"></a>
+</p>
+
+Two CLI modes for two use cases:
+- **`pe persona`** — Generate persistent 7-section system prompts (for saving, sharing, installing into agent configs)
+- **`pe enhance-task`** — Inline task refinement with workspace context (like Auggie's Ctrl+P)
+
+The CLI is `pe` (short) and `prompt-enhancer` (long). Both work identically.
+
+## Install
+
+```bash
+pip install prompt-enhancer-cli
+```
+
+Or install directly from source:
+
+```bash
+pip install git+https://github.com/hongphuc5497/prompt-enhancer.git
+```
+
+> The PyPI distribution is `prompt-enhancer-cli` (the bare name `prompt-enhancer`
+> was already taken). The command is still `pe` (or `prompt-enhancer`) — only
+> the install line changes.
+
+Set your API key:
+```bash
+echo "LLM_API_KEY=*** > ~/.prompt-enhancer.env
+```
+
+Config (`~/.prompt-enhancer.env`):
+```env
+LLM_API_KEY=***i...ps://api.deepseek.com
+LLM_MODEL=deepseek-chat
+```
+
+Any OpenAI-compatible API works: DeepSeek, OpenAI, OpenRouter, Together, Groq, etc.
+
+## Quick start
+
+```bash
+# Generate a 7-section system prompt
+pe persona "a senior Rust developer who prefers functional programming"
+
+# Inline task refinement (Auggie Ctrl+P style)
+pe enhance-task "fix the login bug in the auth module"
+
+# Safe install into agent config (creates backup if exists)
+pe install "a security reviewer" --agent claude
+
+# Benchmark before vs after
+pe benchmark --enhance "a Go backend dev"
+
+# Health check
+pe doctor
+
+# View analytics
+pe store stats
+```
+
+## Two modes
+
+| Command | Purpose | Output |
+|---------|---------|--------|
+| `pe persona` | Generate persistent system prompt | 7 sections: ROLE, CONTEXT, RULES, TECH, FORMAT, PITFALLS, EXAMPLES |
+| `pe enhance-task` | Inline task refinement | 3-5 sentence focused task prompt with workspace context |
+
+Both modes auto-discover workspace context (`AGENTS.md`, `CLAUDE.md`, `package.json`, `Cargo.toml`, etc.) from the current project.
+
+## What `pe persona` generates
+
+1. **ROLE** — Specific, well-scoped identity
+2. **CONTEXT** — Project specs from workspace files
+3. **BEHAVIORAL RULES** — Communication style, decision-making
+4. **TECHNICAL GUIDELINES** — Testing, code style, architecture
+5. **OUTPUT FORMAT** — Code blocks, explanation style
+6. **PITFALLS / GUARDRAILS** — Anti-patterns, security warnings
+7. **EXAMPLES** — 1-2 realistic interactions
+
+Plus a "pro tip".
+
+## Benchmark
+
+7-dimension rubric scoring (SurePrompts): Role Clarity, Context Sufficiency, Instruction Specificity, Format Structure, Example Quality, Constraint Tightness, Output Validation. Each scored 1–5, max 35.
+
+```bash
+pe benchmark --before raw.txt --after enhanced.md
+pe benchmark --enhance "a Go backend dev"   # all-in-one
+```
+
+| Score | Verdict |
+|-------|---------|
+| 28-35 | Production-ready |
+| 21-27 | Working draft |
+| 14-20 | Needs major revision |
+| 7-13 | Rewrite from scratch |
+
+## Comparison with Auggie
+
+Both this tool and Auggie's native `--enhance-prompt` have their strengths:
+
+| | `pe persona` | `pe enhance-task` | Auggie `--enhance-prompt` |
+|---|---|---|---|
+| **Best for** | Persistent system prompts | Inline task refinement | Inline task refinement |
+| **Output** | 7-section document | 3-5 sentences | 1-3 sentences |
+| **Workspace aware** | Yes (auto-discovers context) | Yes | Yes (native) |
+| **Installable** | Yes (`pe install`) | No | No |
+| **Reusable** | Save, share, version | Session-scoped | Session-scoped |
+| **Benchmark** | Built-in rubric | No | No |
+| **Analytics** | Auto-store | Auto-store | No |
+
+They are complementary tools, not competitors.
+
+## Profiles
+
+| Profile | Focus |
+|---------|-------|
+| `senior-dev` | Technical depth, testing, edge cases |
+| `architect` | System design, trade-offs, scalability |
+| `reviewer` | Security, performance, code smells |
+| `sre` | Observability, reliability, incident response |
+| `product` | User experience, feature prioritization |
+| `mentor` | Teaching, onboarding, pair-programming |
+
+## Agent integration
+
+```bash
+pe install "a Rust dev..." --agent claude    # → CLAUDE.md
+pe install "..." --agent codex               # → .codex/system.md
+pe install "..." --agent cursor              # → .cursorrules
+pe install "..." --agent all                 # → all compatible configs
+```
+
+Safe by default — creates `.bak` backup of existing files. Use `--force` to skip backup, `--dry-run` to preview.
+
+| Agent | Config file | Auto-loaded? |
+|-------|------------|:---:|
+| **Claude Code** | `CLAUDE.md` | ✅ |
+| **Codex** | `.codex/system.md` | ✅ |
+| **OpenCode** | `AGENTS.md` | ✅ |
+| **Cursor** | `.cursorrules` | ✅ |
+| **Auggie** | `AGENTS.md` | ✅ |
+| **Copilot** | `.github/copilot-instructions.md` | ✅ |
+| **Aider** | `.aider-persona.md` | `--system-prompt` flag |
+
+## Analytics store
+
+Every enhancement is auto-logged to `~/.prompt-enhancer/store.jsonl`:
+
+```bash
+pe store list              # Recent enhancements
+pe store stats             # Analytics
+pe store search "rust"     # Search by keyword
+pe store show <id>         # Detailed view
+pe store delete <id>       # Remove a record
+pe store clear             # Wipe all data
+pe store export --format csv  # Export for analysis
+```
+
+First run shows a privacy notice. Use `--no-store` to opt out.
+
+## Demo
+
+See [docs/demo.tape](docs/demo.tape) for the VHS terminal recording script.
+
+## Config
+
+```env
+# ~/.prompt-enhancer.env
+LLM_API_KEY=***i...ps://api.deepseek.com   # Default
+LLM_MODEL=deepseek-chat                    # Default
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). PRs welcome.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

prompt_enhancer_cli-1.5.0/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "prompt-enhancer-cli"
+version = "1.5.0"
+description = "Reverse-engineered from Auggie's Ctrl+P — transforms rough ideas into production system prompts for AI coding agents"
+readme = "README.md"
+requires-python = ">=3.12"
+license = { text = "MIT" }
+authors = [{ name = "hongphuc5497", email = "hongphuc.dthp@gmail.com" }]
+keywords = ["prompt-engineering", "ai", "llm", "claude-code", "codex", "cursor", "auggie", "system-prompt", "agent"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+[project.scripts]
+prompt-enhancer = "prompt_enhancer.cli:main"
+pe = "prompt_enhancer.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/hongphuc5497/prompt-enhancer"
+Repository = "https://github.com/hongphuc5497/prompt-enhancer.git"
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]

prompt_enhancer_cli-1.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

prompt_enhancer_cli-1.5.0/src/prompt_enhancer/__init__.py

@@ -0,0 +1,2 @@
+"""Prompt Enhancer — reverse-engineered from Auggie's Ctrl+P."""
+__version__ = "1.5.0"

prompt_enhancer_cli-1.5.0/src/prompt_enhancer/agents.py

@@ -0,0 +1,205 @@
+"""
+Agent backends for prompt-enhancer — delegate enhancement to existing coding agents.
+
+Each backend takes a seed prompt and returns an enhanced version by shelling out
+to the agent's CLI. No API key needed — uses the agent's existing configuration.
+
+Supported agents:
+    claude   — Claude Code (claude -p)
+    codex    — Codex CLI (codex)
+    auggie   — Auggie (auggie --print)
+    opencode — OpenCode (opencode --print)
+"""
+
+import subprocess
+import sys
+import os
+from pathlib import Path
+
+
+ENHANCEMENT_PROMPT_TEMPLATE = """Transform this rough idea into a 7-section system prompt for AI coding agents. 
+
+SECTIONS: ROLE → CONTEXT → BEHAVIORAL RULES → TECHNICAL GUIDELINES → OUTPUT FORMAT → PITFALLS/GUARDRAILS → EXAMPLES
+
+RULES:
+- Be concrete — reference actual tools, patterns, conventions
+- Be actionable — rules translate directly into agent behavior
+- Be concise — 2-4 bullets per section
+- Include a "pro tip" at the end
+- Output ONLY the system prompt markdown, start with "# System Prompt: <Role>"
+
+## Rough idea
+{seed}
+
+## Output
+# System Prompt:"""
+
+
+def _find_binary(names):
+    """Find the first available binary from a list of names."""
+    for name in names:
+        # Check common locations
+        for prefix in ["", str(Path.home() / ".local/bin/"), str(Path.home() / ".nvm/versions/node/v26.1.0/bin/")]:
+            path = os.path.join(prefix, name)
+            if os.path.exists(path) and os.access(path, os.X_OK):
+                return path
+        # Try which
+        try:
+            result = subprocess.run(["which", name], capture_output=True, text=True, timeout=5)
+            if result.returncode == 0:
+                return result.stdout.strip()
+        except Exception:
+            pass
+    return None
+
+
+def enhance_via_claude(seed, config=None):
+    """Enhance via Claude Code."""
+    binary = _find_binary(["claude"])
+    if not binary:
+        raise RuntimeError("Claude Code not found. Install: npm install -g @anthropic-ai/claude-code")
+
+    prompt = ENHANCEMENT_PROMPT_TEMPLATE.format(seed=seed)
+    result = subprocess.run(
+        [binary, "-p", prompt],
+        capture_output=True, text=True, timeout=120,
+        env={**os.environ, "CLAUDE_CODE_HEADLESS": "1"}
+    )
+    if result.returncode != 0:
+        raise RuntimeError(f"Claude Code failed: {result.stderr[:200]}")
+    return result.stdout.strip()
+
+
+def enhance_via_codex(seed, config=None):
+    """Enhance via Codex CLI."""
+    binary = _find_binary(["codex"])
+    if not binary:
+        raise RuntimeError("Codex not found. Install: npm install -g @openai/codex")
+
+    prompt = ENHANCEMENT_PROMPT_TEMPLATE.format(seed=seed)
+    result = subprocess.run(
+        [binary, prompt],
+        capture_output=True, text=True, timeout=120,
+        env={**os.environ}
+    )
+    if result.returncode != 0:
+        raise RuntimeError(f"Codex failed: {result.stderr[:200]}")
+    return result.stdout.strip()
+
+
+def enhance_via_auggie(seed, config=None):
+    """Enhance via Auggie (Augment)."""
+    binary = _find_binary(["auggie"])
+    if not binary:
+        raise RuntimeError("Auggie not found. Install: npm install -g @augmentcode/auggie")
+
+    prompt = ENHANCEMENT_PROMPT_TEMPLATE.format(seed=seed)
+    result = subprocess.run(
+        [binary, "--print", prompt],
+        capture_output=True, text=True, timeout=120,
+        env={**os.environ}
+    )
+    if result.returncode != 0:
+        raise RuntimeError(f"Auggie failed: {result.stderr[:200]}")
+
+    output = result.stdout.strip()
+    # Strip Auggie's thinking/exploration prefix
+    if "🤖" in output:
+        output = output.split("🤖")[-1].strip()
+    # Strip ANSI escape codes
+    import re
+    output = re.sub(r'\x1b\[[0-9;]*[a-zA-Z]', '', output)
+    return output
+
+
+def enhance_via_opencode(seed, config=None):
+    """Enhance via OpenCode."""
+    binary = _find_binary(["opencode"])
+    if not binary:
+        raise RuntimeError("OpenCode not found.")
+
+    prompt = ENHANCEMENT_PROMPT_TEMPLATE.format(seed=seed)
+    result = subprocess.run(
+        [binary, "--print", prompt],
+        capture_output=True, text=True, timeout=120,
+        env={**os.environ}
+    )
+    if result.returncode != 0:
+        raise RuntimeError(f"OpenCode failed: {result.stderr[:200]}")
+    return result.stdout.strip()
+
+
+# Map agent names to enhancers
+AGENT_ENHANCERS = {
+    "claude": enhance_via_claude,
+    "codex": enhance_via_codex,
+    "auggie": enhance_via_auggie,
+    "opencode": enhance_via_opencode,
+}
+
+
+# Invocation recipes for running an arbitrary prompt through an agent CLI.
+# Used by the blind-judge path so the benchmark judge can differ from the generator.
+AGENT_INVOKERS = {
+    "claude":   {"binary": "claude",   "args": ["-p"],       "env": {"CLAUDE_CODE_HEADLESS": "1"}},
+    "codex":    {"binary": "codex",    "args": [],           "env": {}},
+    "auggie":   {"binary": "auggie",   "args": ["--print"],  "env": {}},
+    "opencode": {"binary": "opencode", "args": ["--print"],  "env": {}},
+}
+
+
+def run_via_agent(prompt, via_agent, timeout=180):
+    """Run a raw prompt through an agent CLI and return its stdout.
+
+    Unlike enhance_via_*, this passes the prompt verbatim — no enhancement
+    template wrapping. Used for blind judging in `pe benchmark --judge-via`.
+    """
+    recipe = AGENT_INVOKERS.get(via_agent)
+    if not recipe:
+        raise RuntimeError(f"Unknown agent: {via_agent}. Supported: {', '.join(AGENT_INVOKERS.keys())}")
+    binary = _find_binary([recipe["binary"]])
+    if not binary:
+        raise RuntimeError(f"{via_agent} not found on PATH")
+    result = subprocess.run(
+        [binary, *recipe["args"], prompt],
+        capture_output=True, text=True, timeout=timeout,
+        env={**os.environ, **recipe["env"]},
+    )
+    if result.returncode != 0:
+        raise RuntimeError(f"{via_agent} failed: {result.stderr[:200]}")
+    output = result.stdout.strip()
+    if via_agent == "auggie":
+        if "🤖" in output:
+            output = output.split("🤖")[-1].strip()
+        import re
+        output = re.sub(r'\x1b\[[0-9;]*[a-zA-Z]', '', output)
+    return output
+
+
+def enhance(seed, via_agent=None, config=None):
+    """Enhance a seed prompt. If via_agent is set, delegate to that agent.
+    Otherwise, use the API key (legacy path).
+    """
+    if via_agent:
+        enhancer = AGENT_ENHANCERS.get(via_agent)
+        if not enhancer:
+            raise RuntimeError(f"Unknown agent: {via_agent}. Supported: {', '.join(AGENT_ENHANCERS.keys())}")
+        return enhancer(seed, config)
+
+    # Fall through to API-key mode — caller must handle
+    raise RuntimeError("No enhancement method available. Use --via <agent> or set LLM_API_KEY.")
+
+
+def get_available_agents():
+    """Return list of agents with available binaries."""
+    available = []
+    for agent, enhancer in AGENT_ENHANCERS.items():
+        try:
+            binary = _find_binary([agent])
+            if binary:
+                available.append((agent, binary, "ready"))
+            else:
+                available.append((agent, None, "not found"))
+        except Exception:
+            available.append((agent, None, "error"))
+    return available