Automic VaultAutomic Vault

brew

Install hstr with Homebrew, apk, apt, dnf, MacPorts, Nix

Bash and zsh history suggest box. Version 3.2 via Homebrew; verified 2026-07-04.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install hstr

local Homebrew formula metadata

MacPortsverified · 94%
sudo port install hstr

MacPorts ports tree · shells/hstr/Portfile · source: api.github.com

Linux

Alpine Linux apkverified · 92%
sudo apk add hstr

Alpine Linux edge package indexes · hstr · source: dl-cdn.alpinelinux.org

Debian aptverified · 92%
sudo apt install hstr

Debian stable package indexes · hstr · source: deb.debian.org

Fedora dnfverified · 92%
sudo dnf install hstr

Fedora Rawhide package metadata · hstr · source: dl.fedoraproject.org

Nixverified · 92%
nix profile install nixpkgs#hstr

nixpkgs package indexes · pkgs/by-name/hs/hstr/package.nix · source: api.github.com

overview

Package summary

Bash and zsh history suggest box

Commands and aliases

  • hh
  • hstr

history

Project history and usage

HSTR is a terminal user-interface for viewing, searching, curating, and reusing bash and zsh command history, with the hh command as a common shortcut.

Project history

The README expands HSTR as HiSToRy and presents it as a more efficient alternative to Ctrl-r for shell history completion. It combines search, navigation, deletion of sensitive or obsolete commands, and bookmarking of favorite commands.

The project evolved into a broadly packaged shell productivity tool, with documentation for bash and zsh bindings, aliases, environment-driven configuration, blacklist behavior, color and layout settings, and shell-history tuning.

Adoption history

The README lists installation documentation for many distributions and package systems, including Ubuntu, Debian, Fedora, CentOS, openSUSE, Gentoo, Alpine, Arch, FreeBSD, Slackware, Void, Haiku, macOS, Nix, Guix, and others. The input metadata also records packages in Alpine, Homebrew, Debian, Fedora, MacPorts, Nix, and Ubuntu.

The project page collects coverage from Linux Magazine, UbuntuGeek, DebianAdmin, Tuxdiary, Softpedia, OSTechNix, videos, and community posts, which fits its role as a discoverable shell workflow enhancer.

How it is used

Users typically add generated bash or zsh configuration to ~/.bashrc or ~/.zshrc, bind HSTR to a key such as Ctrl-r, and optionally define alias hh=hstr.

Configuration is intentionally shell-native: HSTR reads HISTFILE, HSTR_PROMPT, HSTR_IS_SUBSHELL, and HSTR_CONFIG, with options for color, prompt placement, matching mode, duplicate handling, favorites, and blacklists.

Why package nerds care

HSTR is significant in package-manager culture because it is a shell-history tool that crosses the boundary between a packaged executable and user dotfile integration. A package can install the binary, but value comes when the user wires it into readline or zsh keybindings.

It is also one of the better-known examples in the family of TUI shell-history searchers, alongside tools such as fzf-based history widgets and newer history managers.

Timeline

  • 0.2: Early upstream tag appears in the repository.
  • 1.x: The project accumulated a long sequence of tagged releases.
  • 2.x: Later tags continued the shell-history TUI series.
  • 3.x: The v3.2 tag appears after the 3.0 and 3.1 tags.

Related projects

  • Related projects include bash, zsh, readline, fzf history bindings, shell history managers, and terminal bookmark or snippet workflows.

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

  • narrow executable package without higher-risk signals

Signals

  • metadata:no-higher-risk-signals

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 6 platform targets.
  • Installs with 1 runtime dependencies.
  • Build metadata lists 4 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.

local files

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

Config paths the tool may read or write during local use.

Unix
~/.bashrc~/.zshrc~/.hstr_blacklist

executables

Installed executables

CommandKindExposureNote
hhcliglobal executable
hstrcliglobal 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-08
manager version3.2
manager updated2026-07-04
local dataok
upstreamcurrent
latest detectedv3.2

https://github.com/dvorka-oss/hstr

  • okNo freshness warnings were generated.

install metadata

Package metadata

Package keybrew:hstr
Version3.2
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/hstr
Homepagehttps://github.com/dvorka-oss/hstr
Repositoryhttps://github.com/dvorka-oss/hstr
Upstream docshttps://github.com/dvorka-oss/hstr
LicenseApache-2.0
Source archivehttps://github.com/dvorka-oss/hstr/archive/refs/tags/v3.2.tar.gz
Last updated2026-07-04T16:53:43+09:00
Pulseupdated
Dependenciesreadline
Build dependenciesautoconf, automake, libtool, pkgconf
Uses from macOSncurses
Bottleavailable (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

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

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Debian apt95%

hstr 3.1+ds-1+b1

Suggest box like shell history completion

https://github.com/dvorka/hstr

sudo apt install hstr
  • Section: utils
  • Architecture: amd64
  • Source Package: hstr
  • 4 dependencies
  • normalized package name match
  • Matched by: Hstr
Debian stable package indexes · deb.debian.org · Debian stable package indexes: hstr from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Nix95%

hstr

nix profile install nixpkgs#hstr
  • normalized package name match
  • Matched by: Hstr
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/hs/hstr/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
Ubuntu apt95%

hstr 3.1+ds-1build2

Suggest box like shell history completion

https://github.com/dvorka/hstr

sudo apt install hstr
  • Section: universe/utils
  • Architecture: amd64
  • 4 dependencies
  • normalized package name match
  • Matched by: Hstr
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: hstr from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
apk95%

hstr 3.2-r0

Bash and ZSH shell history suggest box

https://github.com/dvorka/hstr

sudo apk add hstr
  • License: Apache-2.0
  • Architecture: x86_64
  • Source Package: hstr
  • 1 dependencies
  • 1 provides
  • normalized package name match
  • Matched by: Hstr
Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: hstr from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz
apk95%

hstr-bash-completion 3.2-r0

Bash completions for hstr

https://github.com/dvorka/hstr

sudo apk add hstr-bash-completion
  • License: Apache-2.0
  • Architecture: x86_64
  • Source Package: hstr
  • normalized package name match
  • Matched by: Hstr
Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: hstr-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz
apk95%

hstr-doc 3.2-r0

Bash and ZSH shell history suggest box (documentation)

https://github.com/dvorka/hstr

sudo apk add hstr-doc
  • License: Apache-2.0
  • Architecture: x86_64
  • Source Package: hstr
  • normalized package name match
  • Matched by: Hstr
Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: hstr-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz
dnf95%

hstr 3.1-7.fc44

Suggest box like shell history completion

https://github.com/dvorka/hstr

sudo dnf install hstr
  • License: Apache-2.0
  • Category: Unspecified
  • Architecture: x86_64
  • Source Package: hstr
  • 6 dependencies
  • 1 provides
  • normalized package name match
  • Matched by: Hstr
Fedora Rawhide package metadata · dl.fedoraproject.org · Fedora Rawhide package metadata: hstr from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst
MacPorts95%

hstr

sudo port install hstr
  • normalized package name match
  • Matched by: Hstr
MacPorts ports tree · api.github.com · MacPorts ports tree: shells/hstr/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

package graph

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

Related tools

  • autoconfBuild dependency declared by Homebrew.
  • automakeBuild dependency declared by Homebrew.
  • libtoolBuild dependency declared by Homebrew.
  • pkgconfBuild dependency declared by Homebrew.

Same workflow

  • bashishShares av.db curated category or tags: bash, cli, shell, system.
  • bashShares av.db curated category or tags: cli, shell, system.
  • brushShares av.db curated category or tags: cli, shell, system.
  • dash-shellShares av.db curated category or tags: cli, shell, system.
  • elvishShares av.db curated category or tags: cli, shell, system.
  • murexShares av.db curated category or tags: cli, shell, system.

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.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated configuration and credential file locations
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment