# Install funzzy with Homebrew, Nix

Lightweight file watcher. Version 1.5.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:funzzy
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install funzzy
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#funzzy
```

  Evidence: nixpkgs package indexes: pkgs/by-name/fu/funzzy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:funzzy
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/funzzy>
- **Version:** 1.5.0
- **Source summary:** Lightweight file watcher
- **Homepage:** <https://github.com/cristianoliveira/funzzy>
- **Repository:** <https://github.com/cristianoliveira/funzzy>
- **Upstream docs:** <https://github.com/cristianoliveira/funzzy#readme>
- **License:** MIT
- **Source archive:** <https://github.com/cristianoliveira/funzzy/archive/refs/tags/v1.5.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- funzzy (cli)
- fzz (cli)
- funzzy (alias)
- fzz (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: 1.5.0
- Local data: ok
- Upstream repository: https://github.com/cristianoliveira/funzzy
- Upstream latest detected: v1.5.0 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

funzzy is a Rust command-line file watcher and task runner that watches paths and runs configured shell commands when matching files change. Its README describes it as a lightweight watcher inspired by antr and entr, with workflows defined in YAML or by piping file lists on standard input.

### Project history

The project is authored by Cristian Oliveira and is packaged as the `funzzy` crate with two binaries, `funzzy` and the short alias `fzz`. The Cargo manifest identifies the package as MIT licensed and points to the GitHub repository as the official source.

The README frames the tool around local developer workflows, especially personal automated checks similar to GitHub Actions. Its configuration evolved from a simple `.watch.yaml` task list into richer formats that share common watch rules and nest task groups.

### Adoption history

Official installation instructions cover Homebrew, Nix, Cargo, source installation, and a Linux install script. That places funzzy in the small-tool ecosystem where developers can install the same workflow runner through a language package manager or an OS package manager.

### How it is used

A typical workflow starts with `funzzy init`, which creates `.watch.yaml`; running `funzzy` or `fzz` then watches the configured paths and runs matching commands. The docs also support one-off shell pipelines such as feeding changed files into `funzzy 'command {{relative_path}}'`.

The configuration format supports command lists, glob-style change patterns, ignore patterns, tasks that run on initialization, target filtering, fail-fast mode, non-blocking cancellation of long-running tasks, and alternate config files via `-c` or `--config`.

### Why package nerds care

funzzy is interesting as a package because it packages the Unix `entr` idea in a Rust binary with a declarative YAML workflow file. It sits between a raw file watcher and a full build system: small enough to install as a CLI, but structured enough to encode repeated local checks.

### Timeline

- 2023: v1.0.0 release notes describe cancellable tasks, filters, command templates, and improved output feedback.
- v1.4.0: README examples document fail-fast and non-blocking workflow usage.
- v1.6.0: Documentation introduces common rules and nested groups for reducing duplicated watch patterns.

### Related projects

- The README explicitly cites antr and entr as inspirations.
- The README notes that yq and nrr pair well with funzzy for extracting commands or speeding JavaScript and TypeScript task execution.

### Sources

- <https://github.com/cristianoliveira/funzzy>
- <https://github.com/cristianoliveira/funzzy/blob/master/Cargo.toml>
- <https://github.com/cristianoliveira/funzzy/blob/master/README.md>
- <https://github.com/cristianoliveira/funzzy/blob/master/docs/USAGE.md>
- <https://github.com/cristianoliveira/funzzy/releases/tag/v1.0.0>


## 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: ./.watch.yaml
## Source Database Details

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

## Other Package-Manager Records

- Nix - funzzy: normalized package name match | nixpkgs package indexes: pkgs/by-name/fu/funzzy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/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.
- [fsw](https://www.automicvault.com/pkg/brew/fsw/) - Shares av.db curated category or tags: automation, cli, developer-tools, file-watcher, file-watching.
- [gaze](https://www.automicvault.com/pkg/brew/gaze/) - Shares av.db curated category or tags: automation, cli, developer-tools, file-watcher, file-watching.
- [watchexec](https://www.automicvault.com/pkg/brew/watchexec/) - Shares av.db curated category or tags: automation, cli, developer-tools, file-watcher, file-watching.
- [watchman](https://www.automicvault.com/pkg/brew/watchman/) - Shares av.db curated category or tags: automation, cli, developer-tools, file-watcher, file-watching.
- [wgo](https://www.automicvault.com/pkg/brew/wgo/) - Shares av.db curated category or tags: automation, cli, developer-tools, file-watcher, file-watching.
- [fswatch](https://www.automicvault.com/pkg/brew/fswatch/) - Shares av.db curated category or tags: cli, developer-tools, file-watcher, file-watching.
- [watcher](https://www.automicvault.com/pkg/brew/watcher/) - Shares av.db curated category or tags: cli, developer-tools, file-watcher, file-watching.
- [entr](https://www.automicvault.com/pkg/brew/entr/) - Shares av.db curated category or tags: automation, cli, developer-tools, file-watcher.

## Combined YAML source

View the package source record on GitHub. [combined/funzzy.yml](https://github.com/automic-vault/db/blob/main/combined/funzzy.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
