VCode - Macro Playground for VS Code

VCode is a focused VS Code extension for macro automation: load, manage, and run macros directly in your editor.

Highlights

Macro Playground for rapid experimentation
File-based macros from .vscode/macro
Quick execution on selection or whole document
Built-in commands to add, edit, delete, and refresh macros

Quick Start

Create a macro file in .vscode/macro/uppercase.js.
Paste this content:

module.exports = (context) => {
  return context.input.toUpperCase();
};

Open Command Palette and run VCode: Execute Macro.
Pick uppercase and see the selection change.

Commands

VCode: Execute Macro
VCode: Add Macro
VCode: Edit Macro
VCode: Delete Macro
VCode: Refresh Macros
VCode: Open Macro Playground

Extension Settings

You can configure VCode settings in your .vscode/settings.json or User Settings.

{
  "vcode.macro.directories": [
    ".vscode/macro"
  ],
  "vcode.macro.globals": {
    "author": "Ada Lovelace",
    "apiBase": "https://example.com"
  },
  "vcode.macro.python.path": "/path/to/venv/bin/python3",
  "vcode.macro.perl.path": "/usr/bin/perl"
}

Writing Macros

Macros can be written in JavaScript, Python, or Perl. JavaScript/Python macros return a string; Perl macros write the result to stdout.

Context Object:

input: Selected text, or the entire document if nothing is selected.
languageId: VS Code language ID (example: typescript).
filePath: Absolute path of the active file.
globals: Global variables from vcode.macro.globals.

JavaScript Macros

JavaScript macros should define a transform function.

function transform(input, context) {
  return input.toUpperCase();
}

Python Macros

Python macros are .py files in .vscode/macro and must define transform(input, context, *args).

def transform(input, context, *args):
    return input.upper()

Python macros run with the configured interpreter. Set vcode.macro.python.path if you need a specific virtualenv or interpreter. If unset, VCode uses the Python extension's default interpreter or falls back to python3.

Perl Macros

Perl macros are .pl files in .vscode/macro and should be standalone programs. VCode sends the selected text to stdin and reads the transformed output from stdout. Set vcode.macro.perl.path if you need a specific Perl interpreter.

Environment variables:

VCODE_LANGUAGE_ID
VCODE_FILE_PATH
VCODE_GLOBALS_JSON
VCODE_CONTEXT_JSON
VCODE_PARAMS_JSON Note: VCODE_CONTEXT_JSON includes metadata (languageId, filePath, globals). The input text is provided via stdin.

#!/usr/bin/env perl
use strict;
use warnings;

local $/;
my $input = <STDIN> // q{};
print $input;

Macro Playground

Open Macro Playground from the Command Palette to run code quickly, save new macros, and load existing ones without leaving the editor. You can choose the runtime (JavaScript, Python, or Perl) before running or saving.

Privacy

VCode runs macros locally inside the VS Code extension host and does not send code or content to external services.

Release Notes

See CHANGELOG.md for details.

License

MIT

vcode

npv2k1