Skip to content

arturo-lang/vscode-extension

Repository files navigation

Arturo for VS Code

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


Arturo logo Arturo logo
~ 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.

About

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

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

 

Contributors 3

  •  
  •  
  •