install

Additional install commands

macOS

Homebrewverified · 100%

brew install peco

local Homebrew formula metadata

MacPortsverified · 94%

sudo port install peco

MacPorts ports tree · sysutils/peco/Portfile · source: api.github.com

Linux

Debian aptverified · 92%

sudo apt install peco

Debian stable package indexes · peco · source: deb.debian.org

Nixverified · 92%

nix profile install nixpkgs#peco

nixpkgs package indexes · pkgs/by-name/pe/peco/package.nix · source: api.github.com

Arch Linux pacmanverified · 92%

sudo pacman -S peco

Arch Linux sync databases · peco · source: geo.mirror.pkgbuild.com

Windows

Scoopverified · 92%

scoop install main/peco

Scoop official bucket manifest trees · bucket/peco.json · source: api.github.com

Windows Package Managerverified · 92%

winget install --id peco.peco -e

Windows Package Manager source index · peco.peco · source: cdn.winget.microsoft.com

overview

Package summary

Simplistic interactive filtering tool

Project links

Commands and aliases

peco

history

Project history and usage

peco is a Go-based interactive terminal filter that incrementally narrows streamed text and emits selected lines for use in shell pipelines.

Project history

Daisuke Maki created peco as a Go-based successor inspired by the Python program percol, seeking the same interactive filtering workflow without a Python runtime dependency.

The project grew from a simple incremental selector into a configurable terminal interface with multiple matching modes, custom filters, selection actions, layouts, ANSI-color handling, and Unix and Windows support.

Adoption history

peco became available through numerous ecosystems, including Homebrew, Debian and Ubuntu, Arch Linux, MacPorts, Nix, Scoop, and winget. The official README additionally documents several platform-specific installation routes.

Its single-binary distribution and pipeline-friendly interface helped it spread through shell functions and terminal workflows.

How it is used

Typical usage pipes logs, process lists, file names, command history, or repository lists into `peco`; the chosen line or lines are written to standard output.

Users can configure keymaps, styles, prompts, layouts, matching filters, and custom external filters in JSON or select another file with `--rcfile`.

Why package nerds care

peco belongs to the lineage of interactive Unix filters that turn standard input into a live selection interface and print selected records to standard output.

It is particularly attractive to package users because its Go implementation produces portable standalone binaries while retaining composability with ordinary shell tools.

Timeline

Initial project era: Daisuke Maki created peco as a standalone Go alternative inspired by percol.
v0.1.3 era: Custom external filters became configurable.
Later releases: Added richer matching, layouts, selection behavior, ANSI-color support, and broader cross-platform packaging.

Related projects

percol is the Python interactive-filtering tool that directly inspired peco.
grep is the non-interactive Unix filter used as a comparison in the official description.
fzf is a related terminal fuzzy finder; peco's official documentation explicitly compares its inline-height behavior with fzf.

Sources

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

narrow executable package without higher-risk signals

Signals

metadata:no-higher-risk-signals

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Build metadata lists 1 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

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

Config paths the tool may read or write during local use.

Unix: $XDG_CONFIG_HOME/peco/config.json~/.config/peco/config.json$XDG_CONFIG_DIRS/*/peco/config.json~/.peco/config.json

executables

Installed executables

Command	Kind	Exposure	Note
`peco`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-09-19

manager version0.6.0

manager updated2026-09-13

local dataok

upstreamcurrent

latest detectedv0.6.0

https://github.com/peco/peco

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:peco
Version	0.6.0
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/peco
Homepage	https://github.com/peco/peco
Repository	https://github.com/peco/peco
License	MIT
Source archive	https://github.com/peco/peco/archive/refs/tags/v0.6.0.tar.gz
Last updated	2026-09-13T06:40:12Z
Pulse	updated
Build dependencies	go
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

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

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Debian apt95%

peco 0.5.10-1+b17

Simplistic interactive filtering tool

https://github.com/peco/peco

sudo apt install peco

Section: devel
Architecture: amd64
Source Package: peco
normalized package name match
Matched by: Peco

Debian stable package indexes · deb.debian.org · Debian stable package indexes: peco from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

Nix95%

peco

nix profile install nixpkgs#peco

normalized package name match
Matched by: Peco

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/pe/peco/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

Ubuntu apt95%

peco 0.5.10-1build1

Simplistic interactive filtering tool

https://github.com/peco/peco

sudo apt install peco

Section: universe/devel
Architecture: amd64
normalized package name match
Matched by: Peco

Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: peco from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz

pacman95%

peco 0.6.0-1

Simplistic interactive filtering tool

https://github.com/peco/peco

sudo pacman -S peco

License: MIT
Architecture: x86_64
1 dependencies
normalized package name match
Matched by: Peco

Arch Linux sync databases · geo.mirror.pkgbuild.com · Arch Linux sync databases: peco from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

MacPorts95%

peco

sudo port install peco

normalized package name match
Matched by: Peco

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

Scoop95%

main/peco

scoop install main/peco

normalized package name match
Matched by: Peco

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

winget95%

peco.peco

winget install --id peco.peco -e

normalized package name match
Matched by: Peco

Windows Package Manager source index · cdn.winget.microsoft.com · Windows Package Manager source index: peco.peco from https://cdn.winget.microsoft.com/cache/source.msix

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/peco.yml

Used sources

Geiger risk classifier
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment
pkg.so package database
pkgdb category and tag curation

Install peco with Homebrew, apt, MacPorts, Nix, pacman, scoop, winget

Additional install commands

macOS

Linux

Windows

Package summary

Project links

Commands and aliases

Project history and usage

Project history

Adoption history

How it is used

Why package nerds care

Timeline

Related projects

Sources

Risk level: green

Risk classifier

Why

Signals

Install behavior

Recommended review

Configuration and credential file locations

Configuration files

Installed executables

Version and freshness

Package metadata

Source database details

Other package-manager records

Internal package links

Topical hubs

Related tools

Same workflow

Agent security guides

Generated from repository data

Combined YAML source

Used sources