Automic VaultAutomic Vault

brew

Install hq with Homebrew

Jq, but for HTML. Version 1.2.2 via Homebrew; verified 2026-06-15.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified ยท 100%
brew install hq

local Homebrew formula metadata

overview

Package summary

Jq, but for HTML

Commands and aliases

  • hq

history

Project history and usage

hq is a Rust command-line tool for extracting structured JSON from HTML with CSS selectors. Its README summarizes the idea as `jq, but for HTML`.

Project history

The project lives in the `orf/html-query` repository as a small Rust workspace with crates for the CLI, AST, extractor, and web UI. The README documents a selector syntax that looks JSON-shaped but uses CSS selectors as values, then emits JSON output.

Adoption history

hq is packaged through Homebrew and published on crates.io as `html-query`. The crates.io metadata records the crate creation in December 2022 and points back to the upstream repository lineage, while the README documents installation through either `brew install hq` or `cargo install html-query`.

How it is used

Users pass hq a query such as `{posts: .athing | [{title: .titleline > a}]}` to select HTML elements and shape the result as JSON. The documented syntax includes text extraction, attribute extraction, parent selection, sibling selection, and nested arrays or objects.

The common use case is quick shell scraping: fetch or pipe HTML, select useful pieces with CSS selectors, and hand the resulting JSON to other command-line tools.

Why package nerds care

hq is interesting because it imports the jq mental model into HTML scraping without trying to become a full crawler or browser automation framework. For package nerds, it belongs to the small-tool lineage where each file format gets a composable query command.

It also shows a familiar Rust CLI distribution pattern: a crates.io package for Cargo users, a GitHub repository with a web demo, and a Homebrew formula for users who want a binary package.

Timeline

  • 2022: crates.io records the `html-query` crate creation.
  • 2023: crates.io records version 1.2.2 of `html-query`.
  • 1.2.2: Homebrew packages hq from the upstream `html-query-v1.2.2` GitHub archive.

Related projects

  • jq is the direct conceptual comparison used in the hq README.
  • CSS selector engines and Rust HTML parsing crates provide the underlying interaction model.
  • htmlq is a related but separate CLI in the broader `jq for HTML` family.

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for hq. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 10 platform targets.
  • Build metadata lists 1 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

CommandKindExposureNote
hqcliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-25
manager version1.2.2
manager updated2026-06-15
local dataok
upstreamnot checked
latest detectednot detected

https://github.com/orf/html-query

install metadata

Package metadata

Package keybrew:hq
Version1.2.2
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/hq
Homepagehttps://orf.github.io/html-query/
Repositoryhttps://github.com/orf/html-query
Upstream docshttps://github.com/orf/html-query#readme
LicenseMIT
Source archivehttps://github.com/orf/html-query/archive/refs/tags/html-query-v1.2.2.tar.gz
Last updated2026-06-15T10:20:18-04:00
Pulseupdated
Build dependenciesrust
Bottleavailable (on arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, monterey, sonoma, ventura, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Namehq
Version Scheme0
Revision0
Conflicts With
  • proxygen
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • stable

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Related tools

  • rustBuild dependency declared by Homebrew.

Same workflow

  • htmlqShares av.db curated category or tags: cli, css-selectors, developer-tools, html, scraping.
  • cascadiaShares av.db curated category or tags: cli, css-selectors, developer-tools, html.
  • htmlcleanerShares av.db curated category or tags: cli, developer-tools, html, parser.
  • htmlcxxShares av.db curated category or tags: cli, developer-tools, html, parser.
  • jshonShares av.db curated category or tags: cli, developer-tools, json, parser.
  • jsonlintShares av.db curated category or tags: cli, developer-tools, json, parser.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/hq.yml

Used sources

  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated package history
  • package relationship graph
  • package version freshness
  • package-page enrichment