https://github.com/grazen0/ppick

A simple, no-fuss TUI picker menu.
https://github.com/grazen0/ppick

Last synced: 12 months ago
JSON representation

A simple, no-fuss TUI picker menu.

• Host: GitHub
• URL: https://github.com/grazen0/ppick
• Owner: Grazen0
• License: mit
• Created: 2025-03-14T19:20:32.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2025-03-15T19:13:30.000Z (12 months ago)
• Last Synced: 2025-03-15T19:23:49.050Z (12 months ago)
• Language: Rust
• Size: 15.6 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ppick · [![Tests](https://github.com/Grazen0/ppick/actions/workflows/tests.yml/badge.svg)](https://github.com/Grazen0/ppick/actions/workflows/tests.yml)

A simple, no-fuss CLI picker menu.

[ ![asciicast](https://asciinema.org/a/708394.svg) ](https://asciinema.org/a/708394)

It matches entries by *prefix* (hence the name, as in "prefix-pick") and exits the program as soon as there is only one selectable entry left.

## Usage

Entries (newline-separated) are piped in via stdin, and the selected entry is piped via stdout. For example:

```bash

result=$(printf "foo\nbar\nbaz" | ppick)

```

Use `ppick --help` to find more about the possible flags.

### Features

- [ ] Supports Unicode (probably already does, but needs testing).

- [ ] Allows showing the current query.

## Development

If you use [Nix](https://nixos.org/), you already know what to do (wink).

If not, just use Cargo. Everything should work out of the box.

## Credits

- [mini.starter](https://github.com/echasnovski/mini.starter) - main inspiration.

- [fzf](https://github.com/junegunn/fzf) - reference for program behavior.

- [yazi](https://github.com/sxyazi/yazi) - reference for man pages and shell completion generation.