guesswork

Counts real <code>git clone</code>s of this repo — every first-time <code>install.sh</code> run does one internally, plus some people who clone without installing, so treat it as a close proxy, not a byte-exact install count.</sub>
</p>

```sh
curl -fsSL https://guesswork.findmalek.com/install.sh | bash
```

- **AI-ranked, not prefix-matched** — understands abbreviations and fuzzy
  matches, not just commands that start with what you typed
- **Fish-style inline suggestions** — grey text after your cursor, accept
  with <kbd>→</kbd>, works in emacs and vi keymaps
- **Four providers** — TypeSafe or Cloudflare Workers AI run the real Jev
  model; Anthropic or Groq work as fallbacks if you'd rather not sign up for
  either
- **Runs anywhere zsh does** — hooks `zle` directly, no raw escape codes, no
  terminal-specific code path
- **Cheap** — ~$0.000081 per request on Jev; a few hundred requests a day for
  a year lands around $10 total
- **No build step** — plain TypeScript, run directly by Node

**Jump to:** [Install](#install) · [Choose a provider](#choose-a-provider) ·
[Configuration](#configuration) · [How it works](#how-it-works) ·
[What it costs](#what-it-costs) · [CLI](#cli) · [Contributing](#contributing)

Prefix-matching history search only works if you remember how a command
*started*. You know you ran something with `--dir blog` in it last week, but
not whether it began with `amp`, `npm`, or `git`. guesswork closes that gap:
as you type, it asks an AI model which recent command you're most likely
retyping — abbreviations (`gst` → `git status`) and fuzzy matches, not just
literal prefixes — and shows the best guess inline, fish-style, grey text
after your cursor. Press <kbd>→</kbd> to accept it.

```
% gst▌  ⇢ git status  [0.990]                        fuzzy mode: