>_

percol

adds flavor of interactive filtering to the traditional pipe concept of UNIX shell

How to install percol

pip install percol

percol use case

Interactive filtering and selection from piped text input in a terminal, enabling fuzzy search and multi-selection for command-line workflows.

When to use percol

  • Filtering long command outputs to quickly select desired lines (e.g., processes, files).
  • Enhancing shell history search (like zsh history with percol).
  • Building interactive scripts that require user selection from a list.

When not to use percol

  • When non-interactive, automated processing is needed (use grep/awk instead).
  • When the input is not line-based or too large for interactive scrolling.

percol features

  • · Interactive selection with fuzzy matching (including migemo for Japanese, pinyin for Chinese).
  • · Customizable prompt and styles for appearance.
  • · Multiple matching methods (case-sensitive, case-insensitive, regex, migemo, pinyin).
  • · Multi-selection support for picking multiple candidates.

Want your agent to find this automatically?

Add the MCP server to your agent config and it will discover tools like percol on its own.

Set up MCP →

Similar tools to percol