Skip to content
| Marketplace
Sign in
Visual Studio Code>Programming Languages>weirNew to Visual Studio Code? Get it now.
weir

weir

weir-shell

|
2 installs
| (0) | Free
Language support for weir, the typed shell — diagnostics, hover, completion, outline, folding, inlay hints and run/check buttons via `weir lsp`, plus TextMate colorization.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

weir

Language support for weir — a typed shell-scripting language: commands, pipes and files, like bash, with a checker up front. Nothing runs until everything checks.

This extension gives you:

  • Diagnostics as you type — the whole file is checked, every command included; a misspelled external command is underlined before anything runs
  • Hover — types and documentation for every builtin, from the same source the REPL's #help reads
  • Completion — members, keywords, and command names
  • Highlighting — weir's one novel boundary, command versus expression, colored from the parse: command heads as callables, argv as inert words, splice islands as code
  • Outline and folding — types with their fields and cases, functions with their nested functions, imports and signatures; folds for statements, blocks, match arms, comment and import runs
  • Inlay hints — the inferred type after each binder and parameter, the return type before a function's =; each class is a setting under weir.inlayHints, long types show in full in the hint's tooltip
  • Links — click an import path, a schema= name or a #sig tool to open the module, the vendored schema or the signature file
  • Run and check buttons — weir: Run script, Check script and Check script (--can) in the command palette and the editor title, running the same weir binary the server uses in a weir terminal

Debugging

Set a breakpoint in the gutter of a .weir file and press F5. The extension starts weir dap — the same binary as the language server — and you get step in, step over, step out, the call stack, and the names in scope at each frame. The script's output goes to the debug console.

A launch.json is optional. To pass arguments or stop at the first statement:

{
  "type": "weir",
  "request": "launch",
  "name": "deploy to staging",
  "program": "${workspaceFolder}/deploy.weir",
  "args": ["--target", "staging"],
  "stopOnEntry": true
}

Not there yet: pausing a running script, evaluating expressions (a hover reads a name), and expanding records or sequences in the variables pane.

Requires weir

The language server is the weir binary itself (weir lsp) — install it first:

curl -fsSL https://weir.sh/install.sh | sh

Windows: irm https://weir.sh/install.ps1 | iex

The extension finds weir on PATH, then in ~/.local/bin (GUI editors often see a shorter PATH than your shell). If it lives elsewhere, set weir.serverPath to the absolute path of the binary — the path only; the extension runs <path> lsp itself.

Learn weir

  • The guide — from first script to parallelism
  • The reference — the language and every module
  • Coming from bash, PowerShell, Python…

The extension versions independently of weir — a highlighting fix does not wait for a weir release, and any recent weir works.

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