# Install leaf with Homebrew, MacPorts, scoop

General purpose reloader for all projects. Version 1.3.0 via Homebrew; verified 2026-05-23. Also installable with macports: sudo port install leaf.

## Install

```sh
sudo av install brew:leaf
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install leaf
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install leaf
```

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

### Windows

- Scoop (92%):

```sh
scoop install main/leaf
```

  Evidence: Scoop official bucket manifest trees: bucket/leaf.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:leaf
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/leaf>
- **Version:** 1.3.0
- **Source summary:** General purpose reloader for all projects
- **Homepage:** <https://pkg.go.dev/github.com/vrongmeal/leaf>
- **Repository:** <https://github.com/vrongmeal/leaf>
- **Upstream docs:** <https://github.com/vrongmeal/leaf#readme>
- **License:** MIT
- **Source archive:** <https://github.com/vrongmeal/leaf/archive/refs/tags/v1.3.0.tar.gz>
- **Last updated:** 2026-05-23T01:03:32+09:00
- **Generated:** 2026-07-25T07:20:51+00:00

## Executables

- leaf (cli)
- leaf (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura

## Freshness

- Page generated: 2026-07-25
- Package-manager version: 1.3.0
- Package-manager updated: 2026-05-23
- Local data: ok
- Upstream repository: https://github.com/vrongmeal/leaf
- Upstream latest detected: v1.3.0 (current)
## Project history and usage

leaf is a small Go hot-reloader for command-line development workflows. It watches a project directory and runs configured commands when files change, making it a lightweight alternative to framework-specific reloaders.

### Project history

The public GitHub tags show leaf reaching v1.0.0 on February 23, 2020. The project evolved quickly in early 2020 with Cobra/Viper command-line configuration, a v1.2.0 internal rewrite around process contexts, and v1.3.0 in September 2020.

### Adoption history

Adoption evidence is modest and package-manager oriented: Homebrew, MacPorts, and Scoop package it as a general-purpose reloader rather than as a tool tied to one language framework.

### How it is used

The CLI watches the working directory, applies include/exclude filters, and runs one or more commands on file updates. Its default config path is <CWD>/.leaf.yml, which keeps it close to the project being reloaded.

### Why package nerds care

leaf is notable as a tiny cross-project hot-reload utility in the Go ecosystem: useful for package collections because it occupies the space between language-specific dev servers and larger file-watcher automation tools.

### Timeline

- 2020-02-23: v1.0.0 tag published.
- 2020-04-21: v1.2.0 tag described a major internal rewrite around process contexts.
- 2020-09-12: v1.3.0 tag added command-line behavior refinements.

### Related projects

- Related tools include file-watcher and rebuild utilities such as entr, watchexec, reflex, air, and nodemon.

### Sources

- <https://formulae.brew.sh/formula/leaf>
- <https://github.com/vrongmeal/leaf>
- <https://github.com/vrongmeal/leaf/tags>
- <https://pkg.go.dev/github.com/vrongmeal/leaf>


## Security Notes

No matching local secret-handling manifest was found for leaf. Nucleus package metadata is still published here so future coverage has a stable package URL.



## 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: <CWD>/.leaf.yml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** leaf
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Conflicts With:** leaf-md, leaf-proxy
- **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

- MacPorts - leaf: normalized package name match | MacPorts ports tree: sysutils/leaf/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/leaf: normalized package name match | Scoop official bucket manifest trees: bucket/leaf.json from https://api.github.com/repos/ScoopInstaller/Main/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.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [entr](https://www.automicvault.com/pkg/brew/entr/) - Shares av.db curated category or tags: automation, cli, developer-tools, file-watcher.
- [fsw](https://www.automicvault.com/pkg/brew/fsw/) - Shares av.db curated category or tags: automation, cli, developer-tools, file-watcher.
- [funzzy](https://www.automicvault.com/pkg/brew/funzzy/) - Shares av.db curated category or tags: automation, cli, developer-tools, file-watcher.
- [gaze](https://www.automicvault.com/pkg/brew/gaze/) - Shares av.db curated category or tags: automation, cli, developer-tools, file-watcher.
- [hotbuild](https://www.automicvault.com/pkg/brew/hotbuild/) - Shares av.db curated category or tags: cli, developer-tools, file-watcher, go.
- [watchexec](https://www.automicvault.com/pkg/brew/watchexec/) - Shares av.db curated category or tags: automation, cli, developer-tools, file-watcher.
- [watchman](https://www.automicvault.com/pkg/brew/watchman/) - Shares av.db curated category or tags: automation, cli, developer-tools, file-watcher.
- [wgo](https://www.automicvault.com/pkg/brew/wgo/) - Shares av.db curated category or tags: automation, cli, developer-tools, file-watcher.
- [goimports](https://www.automicvault.com/pkg/brew/goimports/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, go.
- [pkgsite](https://www.automicvault.com/pkg/brew/pkgsite/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, go.

## Combined YAML source

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


## Sources

- Nucleus package database
- 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
