Pre-AlphaMetaScript is in early design phase. The compiler is not yet available.Join Discord for updates
MetaScript

Installation

Get MetaScript running in your project in minutes.

Prerequisites

Before installing MetaScript, make sure you have:

  • Node.js 18+ or Bun 1.0+
  • A code editor (we recommend VS Code with our extension)

Quick Install

The fastest way to get started:

npm create metascript@latest my-app
cd my-app
npm run dev

Manual Installation

If you prefer to set things up manually:

1. Install the compiler

npm install -D @metascript/compiler

2. Install the core library

npm install @metascript/core

3. Configure your project

Create a build.ms file in your project root:

// build.ms
export const package = {
  name: "my-app",
  version: "1.0.0",
  backends: ["js"], // or ["c"] or ["erlang"]
};

export const deps = {};

Editor Setup

Install a plugin for syntax highlighting, autocomplete, and LSP support.

VS Code

  1. Open VS Code
  2. Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
  3. Search for "MetaScript"
  4. Click Install

Features: Syntax highlighting, LSP, Debugger integration

Neovim

Using lazy.nvim:

{ "metascriptlang/metascript.nvim" }

Or with packer.nvim:

use "metascriptlang/metascript.nvim"

Features: Syntax highlighting, LSP, Treesitter support

IntelliJ / WebStorm

  1. Open Settings (Cmd+, / Ctrl+Alt+S)
  2. Go to Plugins → Marketplace
  3. Search for "MetaScript"
  4. Click Install and restart

Features: Syntax highlighting, LSP, Run configurations

Account & Identity

Sign in with GitHub to unlock the full MetaScript ecosystem:

msc login

What You Can Do

FeatureDescription
Publish packagesShare your code on pkg.metascriptlang.org
Claim your usernameReserve @yourname for your packages
Create organizationsTeam collaboration with @org/package
Follow packagesGet notified on new releases
Manage API keysAutomate publishing in CI/CD

Your Public Profile

After signing in, your profile at pkg.metascriptlang.org/@username shows:

  • Avatar and bio
  • Published packages
  • Organization memberships
  • Links (GitHub, website, Twitter)

Edit your profile at pkg.metascriptlang.org/account/settings.

Verify Installation

Run the following to verify everything is working:

msc --version

You should see output like:

MetaScript Compiler v0.1.0

Next Steps

Now that you're set up: