twaldin

twaldin / hone

Public

CLI prompt optimizer built on GEPA. Uses coding CLI subscriptions (Claude Code, Codex, OpenCode, Gemini) as the mutation engine — no API keys required.

14
2
100% credibility
Found Apr 20, 2026 at 14 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Hone is a tool that iteratively improves AI prompts by generating variations using AI services and scoring them against a user-defined evaluator to find the highest-performing version.

How It Works

1
📖 Discover Hone

You hear about a helpful tool that automatically improves your messages to AI assistants by testing many versions to find the best one.

2
💻 Set it up

You easily add the tool to your computer so it's ready to help refine your prompts.

3
🖋️ Write your starting message

You create a simple text file with the basic instruction or prompt you want to make better.

4
📊 Build a scorer

You make a little tester program that reads your prompt, checks how well it works on sample tasks, and gives it a number score from 0 to 1.

5
🚀 Launch the improver

You tell the tool your starting message, your scorer, which of your AI helpers to use for suggestions, and how many rounds to try.

6
Watch it evolve

The tool creates new versions of your message, scores each one, keeps the winners, and repeats until it finds top performers.

🎉 Enjoy the upgraded prompt

You get a much better message that scores way higher on your tests, making your AI assistant perform like a pro.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 14 to 14 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is hone?

Hone is a Python CLI prompt optimizer that refines your prompts using AI coding subscriptions like Claude Code, Codex, or Gemini via their official CLIs—no API keys needed. Feed it a prompt file and a grader script that scores performance (e.g., on real GitHub bugs), set a budget like `hone run prompt.md --grader grader.sh --budget 20`, and it proposes mutations, evaluates, and outputs the top-scoring variant. Built on GEPA for Pareto-frontier optimization, it leverages tools like harness for seamless CLI integration across Linux, Ubuntu, or Windows.

Why is it gaining traction?

It skips paid APIs by routing through your existing Claude CLI prompt or Codex CLI prompt subscriptions, making prompt tuning free if you have Pro access. CLI-first design fits GitHub Actions, CLI GitHub clone workflows, or CLI GitHub Copilot setups, with mutators like `harness:gemini` or custom scripts. Delivers real lifts, like +30% relative gains on unseen GitHub repo bugs via a honed methodology prompt.

Who should use this?

AI agent builders tuning CLI prompts for GitHub Linux or Ubuntu bug fixes. DevOps folks scripting CLI GitHub GH commands or CLI GitHub com packages evaluations. Prompt tinkerers with Claude Code or Copilot CLI prompt files seeking a CLI prompt builder without DSPy overhead.

Verdict

Early alpha (14 stars, 1.0% credibility score) with strong README but light tests—install via pip and test on toy graders first. Solid for GEPA fans optimizing CLI prompts today; skip if you need battle-tested stability.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.