macOS
Homebrewverified · 100%
brew install percollocal Homebrew formula metadata
brew / rank 8040
Install percol with Homebrew, apt
Interactive grep tool. Version 0.2.1 via Homebrew; verified from local package data. Also installable with debian: sudo apt install percol.
install
Additional install commands
Linux
Debian aptverified · 92%
sudo apt install percolDebian stable package indexes · percol · source: deb.debian.org
overview
Package summary
Interactive grep tool
Project links
Commands and aliases
- percol
history
Project history and usage
percol is a Python terminal program that turns a stream of lines into an interactive filter-and-select interface.
Project history
Mooz developed percol to add interactive selection to ordinary Unix pipelines. It reads lines from standard input or a file, lets the user filter and select them in a terminal interface, then writes selected lines to standard output.
Adoption history
percol was published as a Python package and entered Debian, Ubuntu, and Homebrew packaging. Its repository records substantial community interest and identifies later interactive filters such as peco and fzf as related projects.
How it is used
Typical uses include interactively selecting processes, searching shell history, choosing tmux sessions, and inserting a selection stage into a Unix pipeline.
Why package nerds care
percol is part of the pre-fzf generation of terminal selectors that made Unix pipelines interactive. Its Python-based `rc.py` configuration exposes prompts, keymaps, colors, and matcher behavior directly to users.
Timeline
- Python 2 era: Released through PyPI as a configurable interactive grep tool.
- Later: Inspired or preceded related terminal selectors including peco and fzf.
Related projects
- The official README names canything and zaw as related predecessors or peers, and peco and fzf as related interactive grep tools.
- peco explicitly credits the original percol project.
Sources
- Official peco repository: https://github.com/peco/peco
- Official percol repository and README: https://github.com/mooz/percol
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 1 platform targets.
- Installs with 1 runtime 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
~/.percol.d/rc.py
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
percol | 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.2.1
manager updated
local dataok
upstreamnot checked
latest detectednot detected
https://github.com/mooz/percol
- infoNo package-manager update timestamp was available.low confidence
- infoNo cached GitHub release or tag data was available.https://github.com/mooz/percolnone confidence
install metadata
Package metadata
| Package key | brew:percol |
|---|---|
| Version | 0.2.1 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/percol |
| Homepage | https://github.com/mooz/percol |
| Repository | https://github.com/mooz/percol |
| License | MIT |
| Source archive | https://files.pythonhosted.org/packages/50/ea/282b2df42d6be8d4292206ea9169742951c39374af43ae0d6f9fff0af599/percol-0.2.1.tar.gz |
| Dependencies | python@3.14 |
| Bottle | available (on all) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | percol |
| Version Scheme | 0 |
| Revision | 4 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
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%
percol 0.2.1-3
interactive selection for UNIX pipes
https://github.com/mooz/percol
sudo apt install percol- Section: utils
- Architecture: all
- 2 dependencies
- 1 optional deps
- normalized package name match
- Matched by: Percol
Ubuntu apt95%
percol 0.2.1-3
interactive selection for UNIX pipes
https://github.com/mooz/percol
sudo apt install percol- Section: universe/utils
- Architecture: all
- 2 dependencies
- 1 optional deps
- normalized package name match
- Matched by: Percol
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.
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