Run for Visual Studio Code

A lightweight Visual Studio Code extension that runs your code using the run CLI tool.

📑 Table of Contents

• Overview
• Features
• Requirement
• Installation
• Usage
• Settings
• Installation
• Contribute
• License

🚀 Overview

This extension is built specifically for users of the run CLI tool:

https://github.com/birukbelihu/run

It integrates the CLI directly into VS Code and provides:

• One-click run
• Auto-save before execution
• Stop running code
• Run selected code
• Run from Explorer
• Output in Terminal or Output panel

No complex configuration. No language mapping.
If run is installed --- it just works.

✨ Features

• ▶ Run current file
• 🖱 Run via editor right-click
• 📁 Run via Explorer right-click
• ✂ Run selected code
• 💾 Auto-save before run
• ⛔ Stop running code
• 🖥 Run in Terminal or Output panel
• 🔍 Automatically checks if run CLI is installed
• 📦 Prompts to install if missing

📦 Requirement

You must install the run CLI tool:

👉 https://github.com/birukbelihu/run?tab=readme-ov-file#installation

If the extension detects that run is not available in your system PATH, it will prompt you to install it.

Installation

1. Open the Extensions panel in Visual Studio Code
   • Ctrl+Shift+X (Windows/Linux)
   • Cmd+Shift+X (macOS)
2. Search for Run VsCode.
3. Install

👉 Install from Visual Studio Code Marketplace

🛠 Usage

▶ Run Code

You can run code using:

• Ctrl + Alt + N
• F1 → Type Run Code
• Right-click in editor → Run Code
• Click Run Code button in title menu
• Right-click file in Explorer → Run Code

⛔ Stop Running Code

• Ctrl + Alt + M
• F1 → Type Stop Code Run
• Click Stop Code Run button

⚙️ Settings

{
    "run-cli.clearPreviousOutput": false,
    "run-cli.saveFileBeforeRun": false,
    "run-cli.saveAllFilesBeforeRun": false,
    "run-cli.runInTerminal": false,
    "run-cli.preserveFocus": true
}

Settings Explained

| Setting | Description | |--------------------------|-------------------------------------------| | clearPreviousOutput | Clear output before each run | | saveFileBeforeRun | Save current file before running | | saveAllFilesBeforeRun | Save all open files before running | | runInTerminal | Run inside Integrated Terminal | | preserveFocus | Keep focus on editor after run |

Contribute

Want to improve Run VSCode? Contributions are welcome!

• Open an issue
• Submit a pull request

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.