Install angle-grinder with Homebrew, MacPorts, Nix, pacman

Project links

• Homepage
• Package manager page

Commands and aliases

• agrind

Project history

The official repository was created in March 2018 and early GitHub releases show rapid 0.x iteration during that same month. Its README frames the project as a tool for cases where logs are available locally but a full analytics stack such as Graphite, Honeycomb, Kibana, Sumo Logic, or Splunk is not.

The tool implements a small functional query language over text, JSON, logfmt, split fields, filters, and aggregate operators. The README emphasizes high-throughput processing, with simple pipelines able to process millions of rows per second.

Adoption history

The README documents binary installation for Linux and macOS, source installation with Cargo, and package-manager availability through Homebrew, MacPorts, and FreeBSD packages. The Homebrew formula and other package-manager entries make it a Unix-toolbox style log utility rather than a service-bound product.

Its adoption is niche but clear: it serves operators and developers who want terminal-native ad hoc analytics against log files, especially when centralized observability tooling is unavailable, too heavy, or not worth setting up.

How it is used

Common usage pipes logs into `agrind` and applies filters and operators such as `json`, `logfmt`, `parse`, `where`, `count`, `sum`, `average`, percentile, and sort. The README example `* | json | count by log_level` captures the usual flow: parse structured logs, group them, and watch live results.

Aliases can be loaded from `.agrind-aliases` in the working directory or parent directories, which lets users keep reusable pipelines close to a project or log format.

Why package nerds care

angle-grinder sits in the package-manager sweet spot for small Rust CLIs: one executable, useful without a daemon, fast enough to justify a native binary, and attractive to users who live in pipes.

It is also a good example of a package whose documentation surface is the README. There is no separate docs site; the official repo is the authoritative manual, release surface, and source.

Timeline

• 2018: Official GitHub repository is created.
• 2018: Early 0.x releases are published in March.
• 2018: README documents Homebrew, MacPorts, FreeBSD, Linux binary, and Cargo installation paths.
• 2018: v0.9.0 adds `agrind --self-update` according to the README.

Related projects

• The README explicitly positions angle-grinder as a lightweight alternative when data is not already in Graphite, Honeycomb, Kibana, Sumo Logic, or Splunk.
• It belongs near command-line text-processing and log tools such as awk, jq, grep, and logfmt parsers, but adds streaming aggregates and a terminal UI.

Sources

• https://api.github.com/repos/rcoh/angle-grinder
• https://api.github.com/repos/rcoh/angle-grinder/releases
• https://raw.githubusercontent.com/rcoh/angle-grinder/master/README.md
• source_facts.package-manager