this repo has no description
1# nlcmd
2
3Type natural language in your terminal, press Ctrl+G, get a shell command.
4
5Inspired by [this tweet](https://x.com/giansegato/status/1980414749407080574).
6
7## Install
8
9```bash
10bun install
11```
12
13## Setup
14
15Add to your `~/.zshrc`:
16
17```zsh
18source /path/to/widget.zsh
19export NLCMD_API_KEY="sk-..."
20```
21
22## Usage
23
241. Type a natural language description of what you want to do
252. Press `Ctrl+G`
263. Watch the command stream in
274. Press Enter to execute (or edit first)
28
29## Examples
30
31```
32find all pdf files in downloads ⟶ find ~/Downloads -name "*.pdf"
33list git branches by date ⟶ git branch --sort=-committerdate
34disk usage top 10 folders ⟶ du -h --max-depth=1 | sort -hr | head -10
35```
36
37## How it works
38
39- `cli.ts` - Bun script using Vercel AI SDK + Claude Haiku 4.5
40- `widget.zsh` - ZSH widget with streaming output via FIFO + animated spinner