HoneIterative Codebase Improvement

A CLI that hones your codebase one principle at a time

Get Started

View on GitHub

Agent-Driven Assessment

Your agent defines the engineering principles. Hone finds the one your code violates most and plans a fix.

Independent Verification

The agent never self-certifies. Hone runs your quality gates as subprocesses and checks exit codes.

Busy-Work Containment

Triage filters out cosmetic refactors, docstring campaigns, and import reorganization before any code changes happen.

GitHub Approval Workflow

In GitHub mode, proposals become issues. The product owner approves or rejects before any code changes are made.

Quick Start

bash

# Install
brew tap svetzal/tap
brew install hone

# Generate an agent and quality gates for your project
hone derive /path/to/project

# Run your first improvement iteration
hone iterate <agent-name> /path/to/project

Learn More

Installation — prerequisites and platform-specific setup
First Iteration — walkthrough from derive to iterate
Iteration Pipeline — how every stage works and why
Agents & Principles — what agents are and how to create them
Quality Gates — independent verification of every change
CLI Commands — all commands, flags, and examples