 _____ _____ _____ 
||h  |||d  |||i  ||
||___|||___|||___||
|/___\|/___\|/___\|

0.24.0

No more searching the README.

"How do I" surfaces install, run, test and deploy steps and commands all in your terminal.

Try the demo ->

Install

brew install grega/tap/hdi

curl -fsSL https://raw.githubusercontent.com/grega/hdi/main/hdi \
      -o ~/.local/bin/hdi && chmod +x ~/.local/bin/hdi

Works on macOS and Linux (probably WSL2 also).

Demo

Try out the demo.

How does it work?

hdi parses a given README's Markdown headings looking for keywords like install, setup, prerequisites, run, usage, getting started, etc. It extracts the fenced code blocks from matching sections and presents them as an interactive, executable list.

Read the blog post →

Usage

Command	Description
`hdi`	Interactive picker — shows all sections (default)
`hdi install`	Just install/setup commands (aliases: `setup`, `i`)
`hdi run`	Just run/start commands (aliases: `start`, `r`)
`hdi test`	Just test commands (alias: `t`)
`hdi deploy`	Just deploy/release commands and platform detection (alias: `d`)
`hdi all`	All sections (aliases: `a`)

Full documentation on GitHub →