Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ToberlerOhn/hades/llms.txt

Use this file to discover all available pages before exploring further.

The hades-language extension brings first-class editor support to Visual Studio Code, giving you syntax highlighting, bracket matching, and automatic comment toggling for every .hds and .hd file you open. It is distributed as a local extension packaged alongside the Hades interpreter, so a one-time install from the source directory is all you need.

​
What the Extension Provides

Syntax Highlighting

TextMate grammar (source.hades) colours keywords, types, strings, numbers, operators, and function names using your active VS Code theme.

File Association

Both .hds and .hd files are automatically recognised as the hades language — no manual file-association settings required.

Bracket Matching

Pairs {}, [], and () are tracked for matching, auto-closing, and surrounding-selection support.

Line Comments

The // comment prefix is registered, so the Toggle Line Comment shortcut works out of the box.

​
Highlighted Language Features

The grammar covers the following token categories:
CategoryExamples
Control keywordsif, else, do, while, for, in, func, return
Type keywordsint, float, bool, str, list, nothing
String literalsSingle-quoted strings with escape sequences
Numeric literalsInteger and float literals
Operators+, -, *, /, %, =, >, <, !, &, |, ^
Function callsAny identifier(...) pattern
Line commentsEverything following // to end of line

​
Installing the Extension

The extension lives in the hades-language/ directory of the Hades repository. Because it is not yet published to the VS Code Marketplace (version 0.0.1), you install it locally using one of the two methods below.
VS Code engine ^1.125.0 is required. Make sure your editor is up to date before installing.
This launches a sandboxed VS Code window with the extension active and is the fastest way to get started without packaging.
1

Open the extension directory

Open the hades-language/ folder in VS Code:
code /path/to/hades/hades-language
2

Install dependencies

If a node_modules/ directory is not already present, install the dev dependencies:
npm install
3

Launch the Extension Development Host

Press F5 (or go to Run → Start Debugging). A new VS Code window opens with the Hades Language Support extension loaded.
4

Open a Hades file

In the new window, open any .hds or .hd file — syntax highlighting activates automatically.

​
Method 2 — Pack and Install as VSIX

This installs the extension permanently into your VS Code profile.
1

Install vsce

The VS Code Extension manager (vsce) is required to build the package:
npm install -g @vscode/vsce
2

Pack the extension

From inside the hades-language/ directory, run:
cd /path/to/hades/hades-language
npm install
vsce package
This produces a hades-language-0.0.1.vsix file.
3

Install the VSIX

In VS Code, open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P), choose Extensions: Install from VSIX…, and select the generated .vsix file.
4

Reload VS Code

Reload the window when prompted. The extension is now permanently installed.

​
File Association

Once installed, VS Code automatically detects .hds and .hd files as the hades language using the contributed language ID hades (aliases: Hades, hades). The language mode indicator in the bottom-right status bar will read Hades.
If a file opens without highlighting (for example because it has no extension), click the language indicator in the status bar and manually select Hades from the list.

​
Extension Details

FieldValue
Extension IDtobyp.hades-language
Display NameHades Language Support
Version0.0.1
Publishertobyp
VS Code Engine^1.125.0
Scope Namesource.hades
Grammar filesyntaxes/hades.tmLanguage.json
Version 0.0.1 is an initial, unreleased build. It is not yet available on the VS Code Marketplace and must be installed from source as described above.

Build docs developers (and LLMs) love

Get started for freeTalk to us