This VS Code extension adds language support for the Oneil programming language.
Current Features
Syntax Highlighting: Enhances code readability with semantic syntax highlighting for Oneil language constructs.
Go to Definition: Jump to the definition of parameters, models, and imported Python files and functions
Hover Information: View the labels and notes associated with a parameter, model, function, or Python module by hovering
Inline Errors: See errors directly in the editor
Rendered View: Preview models with notes rendered as Markdown (math, {{param:value|equation}} interpolation, citations). Prefer a references.bib beside the model or at the workspace root — see the Notes guide chapter.
CLI install / update: Download the Oneil CLI from GitHub Releases via Command Palette commands when it is not already on PATH
Planned Features
We are actively working on expanding the capabilities of this extension. Upcoming features include:
IntelliSense and Autocomplete: Smart code completion for Oneil
More to come!: We're continuously working to improve the development experience for Oneil programmers
Installation
Open VS Code
Go to the Extensions view (Ctrl+Shift+X)
Search for "Oneil"
Click Install
Requirements
Visual Studio Code version 1.0.0 or higher
An Oneil CLI for the language server. The extension can download it from GitHub Releases (Command Palette: “Oneil: Install or Update CLI”, or accept the prompt when none is found). You can also put oneil on your PATH, set ONEIL_PATH, or set Oneil: Server Path to a local build.
Python 3.12 for the release CLI (brew install python@3.12, the python.org 3.12 installer, or uv python install 3.12). The extension downloads the archive that matches that layout.
[!NOTE]
oneil.serverPath always wins over the extension-managed install. Clear it to use managed updates / version selection. Use Oneil: Select CLI Version… to install a different published release (re-downloads over the managed binary). Use Oneil: Check for CLI Updates to compare against the latest GitHub release.
