# Install zsh-history-substring-search with Homebrew, apk, MacPorts, Nix, pacman

Zsh port of Fish shell's history search. Version 1.1.0 via Homebrew; verified from local package data. Also installable with nix: nix profile install nixpkgs#zsh-history-substring-search.

## Install

```sh
sudo av install brew:zsh-history-substring-search
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install zsh-history-substring-search
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install zsh-history-substring-search
```

  Evidence: MacPorts ports tree: sysutils/zsh-history-substring-search/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add zsh-history-substring-search
```

  Evidence: Alpine Linux edge package indexes: zsh-history-substring-search from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#zsh-history-substring-search
```

  Evidence: nixpkgs package indexes: pkgs/by-name/zs/zsh-history-substring-search/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S zsh-history-substring-search
```

  Evidence: Arch Linux sync databases: zsh-history-substring-search from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## Package facts

- **Package key:** brew:zsh-history-substring-search
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/zsh-history-substring-search>
- **Version:** 1.1.0
- **Source summary:** Zsh port of Fish shell's history search
- **Homepage:** <https://github.com/zsh-users/zsh-history-substring-search>
- **Repository:** <https://github.com/zsh-users/zsh-history-substring-search>
- **License:** BSD-3-Clause
- **Source archive:** <https://github.com/zsh-users/zsh-history-substring-search/archive/refs/tags/v1.1.0.tar.gz>
- **Generated:** 2026-08-04T22:13:35+00:00

## Uses from macOS

- zsh

## Install behavior

- Post-install hook: not defined
- Caveats: To activate the history search, add the following at the end of your .zshrc: source $HOMEBREW_PREFIX/share/zsh-history-substring-search/zsh-history-substring-search.zsh You will also need to restart your terminal for this change to take effect.
- Bottle: available on all

## Freshness

- Page generated: 2026-08-04
- Package-manager version: 1.1.0
- Local data: ok
- Upstream repository: https://github.com/zsh-users/zsh-history-substring-search
- Upstream latest detected: v1.1.0 (current)
- info: No package-manager update timestamp was available.

## Security Notes

No matching local secret-handling manifest was found for zsh-history-substring-search. Package metadata is still published here so future coverage has a stable package URL.


## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** zsh-history-substring-search
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - zsh-history-substring-search: normalized package name match | nixpkgs package indexes: pkgs/by-name/zs/zsh-history-substring-search/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - zsh-history-substring-search - 1.1.0-r0: normalized package name match | Alpine Linux edge package indexes: zsh-history-substring-search from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh port of the Fish shell's history search | https://github.com/zsh-users/zsh-history-substring-search
- pacman - zsh-history-substring-search - 1.1.0-2: normalized package name match | Arch Linux sync databases: zsh-history-substring-search from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | ZSH port of Fish history search (up arrow) | https://github.com/zsh-users/zsh-history-substring-search
- MacPorts - zsh-history-substring-search: normalized package name match | MacPorts ports tree: sysutils/zsh-history-substring-search/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://pkg.so/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Networking and protocol packages](https://pkg.so/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [zsh-syntax-highlighting](https://pkg.so/brew/zsh-syntax-highlighting/) - Package names and metadata indicate a similar tool family. Shared terms: fish, shell, zsh.
- [zsh-autosuggestions](https://pkg.so/brew/zsh-autosuggestions/) - Package names and metadata indicate a similar tool family. Shared terms: fish, zsh.
- [zsh-navigation-tools](https://pkg.so/brew/zsh-navigation-tools/) - Package names and metadata indicate a similar tool family. Shared terms: history, zsh.

## Sources

- pkg.so package database
- package-page enrichment
- package version freshness
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph