hq

GitHub

A command-line tool for querying and transforming HUML files using jq-style expressions. Built as an experiment in LLM-assisted development with test harness engineering.

Features

  • jq-compatible expression syntax
  • 50+ operators: field access, iteration, filtering, mapping, arithmetic
  • Multiple output formats: HUML, JSON, YAML
  • Semantic comparison for testing (via koanf)

Quick Start

# Install
go install github.com/rhnvrm/hq@latest

# Query a HUML file
hq '.users[] | select(.active)' config.huml

# Transform data
hq '.items | map({name, price})' data.huml

# Output as JSON
hq -o json '.' config.huml

About

hq was built in about 6 hours using an LLM agent with 511 pre-planned test scenarios. The approach: front-load specification into tests, let the agent implement against a fixed target. More details in the blog post.

← Projects