ignr/README.md
onyx-and-iris 70b1c373ae replace huh with promptui
- it gives more control over filtering

add --filter/-f flag, this allows configuration over a prefix vs contains filter

update the README to reflect changes
2025-06-18 03:31:34 +01:00

54 lines
1.3 KiB
Markdown

![Windows](https://img.shields.io/badge/Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white)
![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black)
![macOS](https://img.shields.io/badge/mac%20os-000000?style=for-the-badge&logo=macos&logoColor=F0F0F0)
# ignr-cli
Simple no-frills .gitignore generator backed by the Github API.
![Selection Prompt](./img/selectionprompt.png)
## Install
```console
go install github.com/onyx-and-iris/ignr-cli@latest
```
## Configuration
*flags*
- --token/-t: GitHub authentication token
- note, this tool can be used **without** authenticating but rate limiting will be stricter.
- --height/-H: Height of the selection prompt (default 20)
- --filter/-f: Type of filter to apply to the list of templates (default startswith)
- may be one of (startswith, contains)
*environment variables*
```bash
#!/usr/bin/env bash
export IGNR_TOKEN=<API Token>
export IGNR_HEIGHT=20
export IGNR_FILTER=startswith
```
## Commands
### New
Trigger the selection prompt.
```console
ignr-cli new
```
The prompt filter can be activated by pressing `/`:
![Prompt Filter](./img/promptfilter.png)
## Special Thanks
- [Charm](https://github.com/charmbracelet) for their awesome CLI packages.