# peco/peco

Simplistic interactive filtering tool

Repository: https://github.com/peco/peco
Canonical: https://ross.abutalabs.com/products/peco
Language: Go
License: MIT
License Family: permissive
Last push: 2026-08-22T10:02:34+00:00

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

## Adoption (not part of the score)
Stars 7911, forks 233 (observed 2026-08-28T04:10:09.692442+00:00)

## What it is
peco is a simplistic interactive filtering tool written in Go, released as a single static binary. It lets users incrementally search and filter piped input (like logs, process lists, or file listings) as they type, then output the selected line to stdout for further piping.

## Use cases
- interactively filter command output like ps or find results
- select a file from a list to open or cd into
- drill down through logs with incremental search
- build shell functions to pick git branches or repositories
- exclude lines from results with negative query terms

## When to choose
- you want a single dependency-free binary for interactive filtering
- you pipe text between Unix tools and need to pick a line interactively
- you want percol-like filtering without a Python runtime

## When to avoid
- you need fuzzy file finding with preview panes like fzf offers
- you need a GUI or non-terminal filtering interface
- your filtering needs are fully scriptable with grep or awk

## Facets
- artifact type: cli-tool
- maturity: stable
- function: search-engine, cli, developer-tools
- domain: developer-tools
- platform: windows, bsd, cli, cross-platform
- tags: interactive-filtering, fuzzy-finder, incremental-search, unix-pipes, single-binary, command-line, search, linux, macos

## Member repositories
- peco/peco (main) score 79

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:09.692442+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-29T17:33:17.268903+00:00, confidence not recorded.
  - readme: https://github.com/peco/peco (fetched 2026-08-28T04:10:09.692442+00:00, sha 46cff56574ae)
- Data as of 2026-08-30T08:39:29.467469+00:00.