Skip to content
| Marketplace
Sign in
Visual Studio Code>Programming Languages>Errorwise: Errors in Plain EnglishNew to Visual Studio Code? Get it now.
Errorwise: Errors in Plain English

Errorwise: Errors in Plain English

JarvisAppleSlice

|
1 install
| (0) | Free
Turns confusing error messages into plain-language steps with everyday metaphors. Built for people learning to code.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Errorwise: Errors in Plain English

A VS Code extension for people learning to code. It turns confusing error messages into:

  • What happened: one to three short, plain sentences
  • 💡 Think of it like this: one everyday metaphor that matches how the error really works
  • How to fix it: two to five steps you can check off
  • Stuck? Show me the fix: hidden until you ask, so you try first
  • Remember: one line to keep for next time

The Errorwise panel explaining a Python "not iterable" error next to the code

When the error points at another line too, such as where a missing property is declared, the panel adds a Reference line button that jumps there.

When one typo makes the computer misread the lines after it, Errorwise says so with a Check line N first box, and doesn't send you off fixing lines that were never broken.

A C# typo on line 17 causing an error on line 22, with the "Check line 17 first" box and the fix revealed

How to use it

  • Hover over a red squiggle and click Explain simply

    Hovering over a TypeScript error shows an "Explain simply" link

  • Click the lightbulb 💡 and pick 🎓 Explain simply

    The lightbulb menu with "Explain simply" at the top

  • Put your cursor on a line with an error and press Ctrl+Alt+E (Cmd+Option+E on Mac)

  • Terminal errors: select the error text, then press Ctrl+Alt+E (Cmd+Option+E on Mac), or right-click the selection and choose Errorwise: Explain this error. Errorwise finds the file and line for you.

    A Python NameError from the terminal, explained in the panel with the line highlighted

  • Anything else: copy an error, then run Errorwise: Explain selected text or a copied error from the Command Palette

Works on Windows, Mac and Linux, with Python, JavaScript/TypeScript and C#.

AI or no AI

If an AI model is available in VS Code (for example GitHub Copilot, including the free plan), Errorwise writes an explanation tailored to your actual code, using your variable names and line numbers. Without Copilot, you can add your own Anthropic API key with Errorwise: Add an Anthropic API key. The key is stored encrypted by VS Code, and each explanation is billed to your Anthropic account.

Without AI, it uses built-in guides for about 50 of the most common beginner errors and squiggles in Python, JavaScript/TypeScript and C#. These also appear instantly while the AI is still writing.

Your code and privacy

Errorwise has no server of its own and collects no usage data.

When it asks an AI for an explanation, it sends:

  • the error message
  • the name of the file (not the folder it is in) and its language
  • about 10 lines of your code around the error
  • for a pasted or terminal error, the text you selected or copied

This goes to whichever AI you use: GitHub Copilot (handled under your Copilot account) or Anthropic (only if you added your own API key). To keep everything on your computer, turn off errorwise.useAI. The built-in guides still work.

Errors that had no built-in guide are remembered on your computer only (the last 50, first line of each), so you can copy them with Errorwise: Copy errors that had no guide if you want to share them as feedback.

Settings

Setting What it does
errorwise.useAI Use AI for tailored explanations (default: on)
errorwise.aiProvider auto (Copilot first, then your API key), copilot, or anthropic
errorwise.anthropicModel The Claude model used with your API key (default: claude-opus-5-5)
errorwise.experienceLevel brand new or a few months
errorwise.metaphorTheme Where metaphors come from: cooking, sports, video games, school, building, cars, or anything relatable
errorwise.showHoverLink Show the "Explain simply" link on hover

Commands

Command What it does
Errorwise: Explain the error at my cursor Explain the squiggle on the current line
Errorwise: Explain selected text or a copied error Explain any error text
Errorwise: Add an Anthropic API key Use your own key when Copilot isn't available
Errorwise: Remove the Anthropic API key Delete the stored key
Errorwise: Copy errors that had no guide Copy the error messages that had no built-in guide, to share as feedback

Developing

npm install
npm test          # compiles and runs the tests

Press F5 to open a test window with the extension loaded. It opens the examples folder, which is full of deliberate mistakes to try (see examples/README.md).

To build an installable file: npm run package → errorwise-<version>.vsix, then in VS Code run Extensions: Install from VSIX…. Packaging bundles the code with esbuild into dist/extension.js. Testers can follow TESTING.md.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft