# Install gaze with Homebrew

Execute commands for you. Version 1.2.1 via Homebrew; verified 2026-07-25.

## Install

```sh
sudo av install brew:gaze
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install gaze
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:gaze
- **Package manager:** Homebrew
- **Version:** 1.2.1
- **Source summary:** Execute commands for you
- **Homepage:** <https://github.com/wtetsu/gaze>
- **Repository:** <https://github.com/wtetsu/gaze>
- **Last updated:** 2026-07-25T20:55:21-04:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- gaze (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.2.1
## Project history and usage

Gaze is a command-line file watcher that runs commands when files change. Its README describes the tool as a way to stay focused on code while Gaze reruns tests, linters, builds, scripts, or servers after saves.

### Project history

The official repository was created in 2019 and is maintained as a Go CLI. The project emphasizes out-of-the-box defaults, language-agnostic command execution, pattern matching, restart behavior, timeouts, multi-command runs, and a YAML configuration view.

### Adoption history

Official adoption evidence is light, but the project is packaged in Homebrew and published with cross-platform binaries. The README also positions Gaze for modern AI-assisted development workflows, where an agent edits files and a watcher reruns checks automatically.

### How it is used

The simplest use is `gaze .` or `gaze a.py`; Gaze watches matching files and runs a default or user-specified command. Users can pass glob patterns, set a custom command with `-c`, restart previous processes with `-r`, set timeouts with `-t`, and inspect default YAML with `gaze -y`.

### Why package nerds care

Gaze belongs to the family of small developer-loop CLIs where the package is valuable because it removes shell glue from everyday workflows. It is package-manager relevant as a single binary alternative to language-specific watchers, with defaults for many languages and no project-specific dependency stack.

### Timeline

- 2019: The official GitHub repository was created.
- 2020s: The project published tagged releases and cross-platform binaries.
- 2020s: The README added AI-agent workflow examples alongside traditional save-and-run usage.

### Related projects

- Gaze is related to file-watching command runners and developer-loop automation tools. Its README explicitly compares the workflow to running tests, linters, builds, scripts, and server restarts after source changes.

### Sources

- <https://github.com/wtetsu/gaze>
- <https://github.com/wtetsu/gaze#readme>
- <https://github.com/wtetsu/gaze/releases>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Combined YAML source

View the package source record on GitHub. [combined/gaze.yml](https://github.com/mxcl/pkgdb/blob/main/combined/gaze.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph