1 What STT heard

Dictation uses your browser's own speech recognizer. In Chrome that is a cloud service: it streams your microphone audio to Google. The transcript it returns is then corrected here, on this page.

2 What the agent gets

3 Your lexicon

Add a term

Export for your dictation app


      

Install

Pick one. Each takes about a minute. Ordinary correction stays on the machine. lexicon voice downloads a whisper model the first time, lexicon pack fetches a registry URL you chose, and the GitHub importer calls the GitHub API through your existing gh login.

  1. Script (macOS, Linux)
    curl -fsSL https://ashlrai.github.io/lexicon/install.sh | sh
  2. Homebrew
    brew install ashlrai/tap/lexicon
  3. npm (Node 20+)
    npm i -g @ashlr/lexicon

Then run lexicon setup. It seeds your lexicon with your name and company, harvests the current repo, registers the MCP server and hooks in Claude Code, Codex, Cursor and the other clients it finds, and exports to your dictation app. Run from a terminal, the script runs it for you; under sudo or without a terminal it only installs.

Downloads

From the latest release. Checksums are in SHA256SUMS next to them.

Extensions load unpacked from chrome://extensions or about:debugging. LexiconBar is ad-hoc signed: right-click, Open on first launch. Walkthrough in docs/QUICKSTART.md.

Star Lexicon

If a name came out right, star the repo. That is how the next person who dictates a company name finds it.

Star on GitHub

Questions

What is Lexicon?

One YAML file of the words you say. It rewrites a transcript before an agent reads it. It is not a dictation app.

How does an agent install it?

curl -fsSL https://ashlrai.github.io/lexicon/install.sh | sh, then lexicon setup --dry-run --json. The script runs setup only in a terminal. Under sudo, without a terminal, or with LEXICON_NO_SETUP=1, it prints run: lexicon setup.

Does this page send my text anywhere?

No. The matcher runs in your browser. Dictation is the exception: Chrome's speech recognizer sends audio to Google. The corrected text stays on the page.

The longer answers are on lexicon.ashlr.ai and in llms-full.txt.