# facebook/PathPicker

PathPicker accepts a wide range of input -- output from git commands, grep results, searches -- pretty much anything. After parsing the input, PathPicker presents you with a nice UI to select which files you're interested in. After that you can open them in your favorite editor or execute arbitrary commands.

Repository: https://github.com/facebook/PathPicker
Canonical: https://ross.abutalabs.com/products/pathpicker
Homepage: https://facebook.github.io/PathPicker/
Language: Python
License: MIT
License Family: permissive
Last push: 2024-09-05T13:30:40+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4142, "days_push": 727, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5223, forks 281 (observed 2026-08-28T04:09:13.235391+00:00)

## What it is
PathPicker (fpp) is a Python-based command line utility that parses piped input (git output, grep results, find listings) for file paths and presents an interactive terminal UI to select them. Selected files can then be opened in your $EDITOR or used in an arbitrary shell command.

## Use cases
- select files from git status or git diff output to edit
- pick files from grep results and open them in an editor
- interactively choose files from find output to run a command on
- add selected files to version control from bash output
- batch open files mentioned in build or test output

## When to choose
- you frequently select files out of terminal output like git status, grep, or find
- you want a fast keyboard-driven file picker inside the shell
- you want to pipe any command's output into an interactive selector

## When to avoid
- you need a GUI file picker or mouse-driven interface
- you are not comfortable with terminal-based workflows
- you need Windows-native support without a POSIX-like environment

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: cli, terminal-ui, developer-tools, file-system, parser
- domain: developer-tools, version-control
- platform: cli, python, cross-platform
- tags: file-selector, pipe-tool, tui, editor-integration, shell-utility, command-line, macos, linux

## Member repositories
- facebook/PathPicker (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:13.235391+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:00:08.220760+00:00, confidence not recorded.
  - readme: https://github.com/facebook/PathPicker (fetched 2026-08-28T04:09:13.235391+00:00, sha dfc7501bdc5a)
  - homepage: https://facebook.github.io/PathPicker/ (fetched 2026-08-29T08:55:01.674673+00:00, sha f4d7b437a6c7)
- Data as of 2026-08-30T08:39:29.467469+00:00.