# Install gruyere with Homebrew

TUI program for viewing and killing processes listening on ports. Version 0.1.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:gruyere
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install gruyere
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:gruyere
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/gruyere>
- **Version:** 0.1.0
- **Source summary:** TUI program for viewing and killing processes listening on ports
- **Homepage:** <https://github.com/savannahostrowski/gruyere>
- **Repository:** <https://github.com/savannahostrowski/gruyere>
- **Upstream docs:** <https://github.com/savannahostrowski/gruyere#readme>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/16/0f/d951dda46ba3b3dcbdf14f55355130b016445f9aa6b021dd70a9a567026a/gruyere-0.1.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- gruyere (cli)
- gruyere (alias)

## Dependencies

- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.1.0
- Local data: ok
- Upstream repository: https://github.com/savannahostrowski/gruyere
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

Gruyere is a small Python terminal UI for viewing and killing processes listening on ports. Its README positions it as a prettier interactive alternative to manually combining port-inspection commands with process termination.

### Project history

The GitHub repository was created in February 2023. Its public release stream begins with v0.0.3 in October 2025 and reaches v0.1.0 in November 2025, indicating a young, focused utility rather than a long-lived ecosystem project.

### Adoption history

The project is packaged for Homebrew and installable through Python tool installers such as uv tool, pipx, and pip according to the README. Adoption evidence is therefore limited but fits a familiar developer-tool niche: quickly freeing a port during local development.

### How it is used

Users run `gruyere` to list listening processes, filter by port or user, inspect details, navigate with arrow or vim-style keys, and kill a selected process after confirmation. On macOS, the README notes that elevated privileges may be needed for system-wide process visibility.

### Why package nerds care

Gruyere is package-manager interesting mainly as a tiny TUI wrapper around operating-system process and port inspection. It packages a recurring shell workflow into one command while leaving permissions and platform differences visible to users.

### Timeline

- 2023: GitHub repository created.
- 2025: v0.0.3 release published.
- 2025: v0.1.0 release published.

### Related projects

- pipx and uv tool are documented installation paths for isolated Python CLI use.
- lsof, ss, netstat, and platform process tools are adjacent lower-level tools in the same troubleshooting workflow.

### Sources

- <https://api.github.com/repos/savannahostrowski/gruyere>
- <https://api.github.com/repos/savannahostrowski/gruyere/releases?per_page=50>
- <https://github.com/savannahostrowski/gruyere>


## Security Notes

narrow executable package without higher-risk signals.

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

## Source Database Details

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


## 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.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [killport](https://www.automicvault.com/pkg/brew/killport/) - Shares av.db curated category or tags: cli, ports, process-management, system.
- [supervisor](https://www.automicvault.com/pkg/brew/supervisor/) - Shares av.db curated category or tags: cli, process-management, python, system.
- [cpulimit](https://www.automicvault.com/pkg/brew/cpulimit/) - Shares av.db curated category or tags: cli, process-management, system.
- [daemon](https://www.automicvault.com/pkg/brew/daemon/) - Shares av.db curated category or tags: cli, process-management, system.
- [daemonize](https://www.automicvault.com/pkg/brew/daemonize/) - Shares av.db curated category or tags: cli, process-management, system.
- [hapless](https://www.automicvault.com/pkg/brew/hapless/) - Shares av.db curated category or tags: cli, process-management, python, system.
- [lockrun](https://www.automicvault.com/pkg/brew/lockrun/) - Shares av.db curated category or tags: cli, process-management, system.
- [detach](https://www.automicvault.com/pkg/brew/detach/) - Shares av.db curated category or tags: cli, process-management, system.
- [procs](https://www.automicvault.com/pkg/brew/procs/) - Local package facts share a topical domain. Shared terms: cli, management, process, process-management, processes.

## Combined YAML source

View the package source record on GitHub. [combined/gruyere.yml](https://github.com/automic-vault/db/blob/main/combined/gruyere.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
