Arturo for VS Code

First-class editing, running, and package management support directly inside your favorite text editor.

~ CODE IS ART ~

GitHub License Visual Studio Marketplace Downloads

Requirements

VS Code 1.52.0 or newer
Arturo available on your PATH (used for running, bundling, REPL, and package commands)

See how to install Arturo on our official website.

Highlights

Syntax highlighting for Arturo files.
Distinct file icons (gray for code, purple for tests/config) supporting both light and dark themes.
Ready-to-use snippets for core language constructs (arithmetic, collections, logic, IO, numbers, strings, types, and more)
One-click run of the active file, with diagnostics for runtime errors.
Built-in REPL launcher and bundler workflow.
Integrated package manager commands (install, uninstall, list, remote, update all).
Quick links to documentation and a prefilled issue reporter.

Commands

You can find these in the Command Palette (Ctrl/Cmd + Shift + P) under "Arturo:". The run-current command also appears in the editor title bar for Arturo files.

Command	Purpose
Arturo: Open REPL	Launch an Arturo REPL in a new terminal
Arturo: Run File	Choose any `.art` file in the workspace and run it with diagnostics
Arturo: Run Current File	Run the active Arturo file; saves unsaved edits and surfaces errors inline
Arturo: Bundle File	Pick a script and produce a bundled executable (optional custom output name)
Arturo: Manage Packages	Install, Uninstall, Update and Open Documentation of Packages
Arturo: Open Documentation	Open the Arturo's Documentation on side-view
Arturo: Report Issue	Open GitHub issues with system details prefilled

Grammar

Applies syntax highlight to any Arturo file.
This also supports language config to enhance our editor integration, such as quick comment code or auto-closing pair characters...

Reporting Issues and Reading the Docs

Arturo: Open Documentation opens the latest library docs beside your editor.
Arturo: Report Issue opens the GitHub issue form with OS, Arturo, VS Code, and extension versions prefilled to speed up triage.

Installation

From the VS Code Marketplace.
From source: clone the repo, run npm install, then npm run compile. Launch the extension host with F5. See docs/Setup.md for full contributor setup.

Contributing

PRs and Issues are welcome. Please check docs/Contributing.md before submitting changes.

Arturo

drkameleon