# whatcmd | Developer tool by Shubham Prakash

> Type plain English at your shell prompt and get the right command for your OS and tools. A local model, no API keys, and nothing runs until you press Enter.

Page: https://shubhamcodess.github.io/builds/whatcmd/

## whatcmd

Type plain English at your shell prompt and get the right command for your OS and tools. A local model, no API keys, and nothing runs until you press Enter.

- Page: https://shubhamcodess.github.io/builds/whatcmd/
- Kind: Developer tool, 2026
- Stack: TypeScript, Node.js, Ollama, zsh, bash
- code: https://github.com/shubhamcodess/whatcmd
- live: https://shubhamcodess.github.io/whatcmd/
- package: https://www.npmjs.com/package/@shubhamcodess/whatcmd

### Overview

Type `/w` followed by what you want, such as `/w find files bigger than 100MB`, and the line is replaced with the right command for your machine: `find . -type f -size +100M`. It knows your **OS, shell, GNU or BSD flags and installed tools**, and it **never runs anything** until you press `Enter`.

Measured:

- 217 ms: median end to end, on an M4 Pro
- 92.7%: overall on my 500-case benchmark
- 98.8%: of non-shell requests refused

### What it does

- Reads the man page or help text of the tools you name, so flags are real and not guessed.
- Refine the last command instead of retyping it, and "fix that" knows the exit status.
- Warns before damage, such as recursive deletes, dd, piping curl to a shell and force pushes.
- Looks things up on the web only when the local answer fails, through tiny-browse.

### How it is built

- An output gate rejects non-shell text, repeated requests and copied examples, with targeted retry hints for missing programs and GNU-only flags on macOS.
- Grounding in local docs lifts made-up-tool cases from 0% to 85%.
- 100% repeatable on 50 cases run three times.
- CI, CodeQL, dependency review, secret scanning and a tag-driven release that ships the tested tarball.

### Honest limits

- Small models still pick wrong flags sometimes, so read before you press Enter.
- Benchmarked on macOS only, on one machine, with cases I wrote by hand.
- No fish or Windows shortcut yet.

By Shubham Prakash: https://shubhamcodess.github.io/
