Metadata-Version: 2.3
Name: helpish
Version: 0.8.0
Summary: List English words by length — handy for writing Pilish.
Requires-Dist: textual>=8.2.8
Requires-Dist: wordfreq>=3.1.1
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/gioruffa/helpish
Project-URL: Repository, https://github.com/gioruffa/helpish
Description-Content-Type: text/markdown

# helpish

A terminal app that lists every English word of a given length — handy for writing [Pilish](https://en.wikipedia.org/wiki/Pilish), where each word's length encodes a digit of π.

![helpish showing 5-letter words containing "sha"](screenshot_1.png)

## Usage

Run it without installing using [uvx](https://docs.astral.sh/uv/):

```bash
uvx helpish
```

Or install from PyPI and run the `helpish` command:

```bash
pip install helpish
helpish
```

Run it directly from a checkout with uv:

```bash
uv run helpish
```

- Enter a number to see all words of that length.
- Use the **Contains** field to filter by substring.
- Results are sorted by frequency (most common first).
- Press `Ctrl+C` to quit.

Words come from the [`wordfreq`](https://github.com/rspeer/wordfreq) English word list, ordered by real-world usage frequency.
