# Install angle-grinder with Homebrew, MacPorts, Nix, pacman Slice and dice log files on the command-line. Version 0.19.6 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:angle-grinder ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install angle-grinder ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install angle-grinder ``` Evidence: MacPorts ports tree: textproc/angle-grinder/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Nix (92%): ```sh nix profile install nixpkgs#angle-grinder ``` Evidence: nixpkgs package indexes: pkgs/by-name/an/angle-grinder/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S angle-grinder ``` Evidence: Arch Linux sync databases: angle-grinder from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz ## Package facts - **Package key:** brew:angle-grinder - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.19.6 - **Source summary:** Slice and dice log files on the command-line - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - agrind (cli) - agrind (alias) ## Build dependencies - rust ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.19.6 - Local data: ok - Upstream repository: https://github.com/rcoh/angle-grinder - Upstream latest detected: v0.19.6 (current) - info: No package-manager update timestamp was available. ## Project history and usage angle-grinder is a Rust command-line log analysis tool whose executable, `agrind`, brings query-pipeline style filtering, parsing, aggregation, and live terminal rendering to plain log streams. ### 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 - - - - source_facts.package-manager ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: .agrind-aliases/ in current working directory, parent directories ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** angle-grinder - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - angle-grinder: normalized package name match | nixpkgs package indexes: pkgs/by-name/an/angle-grinder/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman - angle-grinder - 0.19.6-2: normalized package name match | Arch Linux sync databases: angle-grinder from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Slice and dice logs on the command line | https://github.com/rcoh/angle-grinder - MacPorts - angle-grinder: normalized package name match | MacPorts ports tree: textproc/angle-grinder/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [analog](https://www.automicvault.com/pkg/brew/analog/) - Shares av.db curated category or tags: analytics, cli, developer-tools, logs, observability. - [alp](https://www.automicvault.com/pkg/brew/alp/) - Shares av.db curated category or tags: cli, developer-tools, logs, observability. - [grafana](https://www.automicvault.com/pkg/brew/grafana/) - Shares av.db curated category or tags: analytics, cli, developer-tools, observability. - [grafana-alloy](https://www.automicvault.com/pkg/brew/grafana-alloy/) - Shares av.db curated category or tags: cli, developer-tools, logs, observability. - [humanlog](https://www.automicvault.com/pkg/brew/humanlog/) - Shares av.db curated category or tags: cli, developer-tools, logs, observability. - [stern](https://www.automicvault.com/pkg/brew/stern/) - Shares av.db curated category or tags: cli, developer-tools, logs, observability. - [codeburn](https://www.automicvault.com/pkg/brew/codeburn/) - Shares av.db curated category or tags: cli, developer-tools, observability. - [fex](https://www.automicvault.com/pkg/brew/fex/) - Shares av.db curated category or tags: cli, developer-tools, logs, text-processing. - [chars](https://www.automicvault.com/pkg/brew/chars/) - Local package facts share a topical domain. Shared terms: cli, command-line, developer, developer-tools, line. - [emojify](https://www.automicvault.com/pkg/brew/emojify/) - Local package facts share a topical domain. Shared terms: cli, command-line, developer, developer-tools, line. ## Combined YAML source View the package source record on GitHub. [combined/angle-grinder.yml](https://github.com/automic-vault/db/blob/main/combined/angle-grinder.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph