# Lexicon

> Speech-to-text is excellent at English and wrong about your vocabulary. Lexicon is one YAML file of the names, products and acronyms you say out loud, applied to every transcript before an agent reads it.

Lexicon (v0.5.3, MIT) is a free, local, open-source tool for anyone whose
company name, product name, internal system or own surname is consistently
mis-transcribed by speech-to-text. It corrects the transcript before an AI agent
acts on it. It is not a dictation app; it sits after whichever one you use.

Install in one command, on macOS or Linux:

    curl -fsSL https://ashlrai.github.io/lexicon/install.sh | sh

No global install, any platform with Node 20+:

    npx @ashlr/lexicon@latest setup

MCP server config, for any MCP client:

    {
      "mcpServers": {
        "lexicon": {
          "command": "lexicon-mcp",
          "args": []
        }
      }
    }

## Start here

- [Full text for models](https://lexicon.ashlr.ai/llms-full.txt): everything below, in one fetch.
- [Machine-readable install manifest](https://lexicon.ashlr.ai/mcp.json): the MCP config block, the tool list and the per-client commands as JSON.
- [Landing page](https://lexicon.ashlr.ai): what it does, with a live in-browser demo of the matcher.
- [Interactive demo](https://ashlrai.github.io/lexicon/): paste a mis-transcribed sentence, watch it get fixed.

## Docs

- [Quickstart](https://github.com/ashlrai/lexicon/blob/main/docs/QUICKSTART.md): Nothing to working in five minutes.
- [Install into your agents](https://github.com/ashlrai/lexicon/blob/main/docs/CLIENTS.md): Per-client config for the seven supported clients.
- [MCP server reference](https://github.com/ashlrai/lexicon/blob/main/docs/MCP.md): The nineteen tools, two resources and two prompts.
- [Agent-native usage](https://github.com/ashlrai/lexicon/blob/main/docs/AGENT-NATIVE.md): How an agent is meant to chain the tools.
- [For agents](https://github.com/ashlrai/lexicon/blob/main/docs/AGENTS.md): Install and verify Lexicon on a user’s behalf.
- [FAQ](https://github.com/ashlrai/lexicon/blob/main/docs/FAQ.md): The same answers as this page, as markdown.
- [Exports and imports](https://github.com/ashlrai/lexicon/blob/main/docs/EXPORTS.md): Fifteen formats out, seven in.
- [Browser extension](https://github.com/ashlrai/lexicon/blob/main/docs/EXTENSION.md): ChatGPT, Claude, Gemini, Grok, Perplexity, Copilot, Poe.
- [macOS menu bar app](https://github.com/ashlrai/lexicon/blob/main/docs/MACOS-APP.md): Any text field, via the Accessibility API.
- [CLI reference](https://github.com/ashlrai/lexicon/blob/main/docs/CLI.md): All twenty-five commands.
- [Benchmark and method](https://github.com/ashlrai/lexicon/blob/main/docs/BENCHMARK.md): The numbers, the corpus and what still fails.
- [Security and trust model](https://github.com/ashlrai/lexicon/blob/main/SECURITY.md): What is local, and how project files are gated.

## Source and packages

- [Repository](https://github.com/ashlrai/lexicon): MIT, all of it (matcher, CLI, MCP server, extension, macOS app).
- [npm package @ashlr/lexicon](https://www.npmjs.com/package/@ashlr/lexicon)
- [Homebrew](https://github.com/ashlrai/lexicon#install): `brew install ashlrai/tap/lexicon`
- [Releases](https://github.com/ashlrai/lexicon/releases/latest): browser extension and macOS menu bar app downloads.