 _____ _____ _____ 
||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.

Usage

$ cd some-project
$ hdi
[hdi] some-project

 ▸ Installation
  ▶ npm install
    cp .env.example .env

 ▸ Run
    npm run dev

  ↑↓ navigate  ⇥ sections  ⏎ execute  c copy  q quit

Full documentation on GitHub →

Read the blog post →