find-up-cli

The tool provides a command‑line interface that searches for a specified file by traversing upward through parent directories from a given working directory. It accepts a filename argument and optionally a custom starting directory, returning the first matching path it encounters. An additional flag can be used to list every matching file found along the upward walk instead of stopping at the first result.

Typical usage involves invoking the command with the target filename, optionally specifying the working directory with a flag, and receiving the absolute path(s) of the file(s) that exist in the current or ancestor directories. This behavior mirrors the functionality of the associated library API, making it convenient for scripts and terminal workflows that need to locate configuration or resource files without hard‑coding paths.

The utility is distributed as a global npm package, marked as stable, and is intended for developers or system administrators who require a simple, reliable method to locate files relative to the current directory hierarchy.