Rune VS Code Extension

Official VS Code integration for Rune Language.

What Is Rune?

Rune is a custom interpreted programming language designed for readable scripting and interactive development.

This repository provides the official Visual Studio Code extension for authoring and running Rune code.

Installation

From Marketplace

1. Open Extensions in VS Code.
2. Search for Rune Language.
3. Install the extension.

From Source

1. Clone this repository.
2. Install dependencies:

npm install

1. Compile:

npm run compile

1. Press F5 to launch an Extension Development Host.

Features

• Syntax Highlighting
• Snippets
• File Icons
• Run File
• Run Selection
• Interactive REPL Terminal
• Interpreter Discovery
• Settings Integration
• Keyboard Shortcuts

Commands

• Run Rune File: rune.runFile
• Run Rune Selection: rune.runSelection
• Open Rune Terminal: rune.openTerminal

Keyboard Shortcuts

• Ctrl+F5 (Cmd+F5 on macOS): Run Rune File
• Ctrl+Shift+F5 (Cmd+Shift+F5 on macOS): Run Rune Selection
• Ctrl+Shift+T (Cmd+Shift+T on macOS): Open Rune Terminal

Configuration

• rune.interpreterPath: optional interpreter path override
• rune.terminalName: terminal name for execution terminals

Interpreter discovery runs in this order:

1. Configured rune.interpreterPath
2. Workspace-local Rune interpreter
3. System PATH
4. Extension-bundled interpreter

Screenshots

Screenshots will be added in a future documentation pass.

Troubleshooting

Interpreter not found

• Set rune.interpreterPath in VS Code settings.
• Ensure Rune is installed in the workspace, on your system PATH, or bundled with the extension.
• Ensure the configured interpreter path points to a valid executable.

File run aborted after editing

• Save the active Rune file successfully before running it.
• If VS Code cannot save the file, the extension will stop execution instead of running stale content.

Selection execution requires a workspace

• Open a folder workspace before running Rune Selection.

Contributing

See docs/contributing.md for local development, build, and publish guidance.

License

This project is licensed under the MIT License. See LICENSE.

Development

npm install
npm run compile

See docs/contributing.md for full details.