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 devManual Installation
If you prefer to set things up manually:
1. Install the compiler
npm install -D @metascript/compiler2. Install the core library
npm install @metascript/core3. 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
- Open VS Code
- Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
- Search for "MetaScript"
- 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
- Open Settings (Cmd+, / Ctrl+Alt+S)
- Go to Plugins → Marketplace
- Search for "MetaScript"
- Click Install and restart
Features: Syntax highlighting, LSP, Run configurations
Account & Identity
Sign in with GitHub to unlock the full MetaScript ecosystem:
msc loginWhat You Can Do
| Feature | Description |
|---|---|
| Publish packages | Share your code on pkg.metascriptlang.org |
| Claim your username | Reserve @yourname for your packages |
| Create organizations | Team collaboration with @org/package |
| Follow packages | Get notified on new releases |
| Manage API keys | Automate 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 --versionYou should see output like:
MetaScript Compiler v0.1.0Next Steps
Now that you're set up:
- Follow the Quick Start to build your first app
- Learn about Three Runtimes to understand your deployment options
- Explore Compile-Time Power to see what makes MetaScript special