Installation

Get the MetaScript compiler installed in under a minute.

Quick Install (Recommended)

Install MetaScript with a single command:

curl -fsSL https://metascriptlang.org/install.sh | sh

This automatically detects your platform and installs the latest version.

Supported Platforms

Installation Options

Customize the installation with environment variables:

# Install a specific version
MSC_VERSION=0.1.0 curl -fsSL https://metascriptlang.org/install.sh | sh

# Install to a custom directory
MSC_INSTALL_DIR=/opt/metascript curl -fsSL https://metascriptlang.org/install.sh | sh

Manual Installation

If you prefer manual installation or need more control:

Download Binary

1. Go to GitHub Releases

2. Download the archive for your platform:

   • msc-VERSION-darwin-arm64.tar.gz (macOS Apple Silicon)
   • msc-VERSION-darwin-x86_64.tar.gz (macOS Intel)
   • msc-VERSION-linux-x86_64.tar.gz (Linux x86_64)
   • msc-VERSION-linux-arm64.tar.gz (Linux arm64)

3. Extract and install:

tar -xzf msc-*.tar.gz
sudo mv bin/msc /usr/local/bin/
sudo mv lib/* /usr/local/lib/

Build from Source

For development or unsupported platforms:

git clone https://github.com/anthropics/metascript
cd metascript
zig build -Doptimize=ReleaseFast

Requires Zig 0.13+.

Verify Installation

Check that MetaScript is installed correctly:

msc --version

You should see:

Metascript v0.1.0

Editor Setup

Get syntax highlighting, autocomplete, and LSP support.

VS Code

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

Neovim

Using lazy.nvim:

{ "metascriptlang/metascript.nvim" }

IntelliJ / WebStorm

1. Open Settings → Plugins → Marketplace
2. Search for "MetaScript"
3. Install and restart

Sign In (Optional)

Connect your GitHub account to publish packages:

msc login

This unlocks:

• Publishing to pkg.metascriptlang.org
• Your @username namespace
• Organization management
• API keys for CI/CD

Uninstall

To remove MetaScript:

rm -rf ~/.metascript

Then remove the PATH entry from your shell config (~/.zshrc, ~/.bashrc, etc.)

Troubleshooting

"command not found: msc"

Add MetaScript to your PATH:

export PATH="$HOME/.metascript/bin:$PATH"

Add this line to your ~/.zshrc or ~/.bashrc to make it permanent.

Permission denied

If you get permission errors, ensure the binary is executable:

chmod +x ~/.metascript/bin/msc

Missing shared libraries (Linux)

On Linux, you may need ICU libraries:

# Ubuntu/Debian
sudo apt install libicu70

# Fedora/RHEL
sudo dnf install libicu

Next Steps

• Quick Start — Build your first app
• Three Runtimes — Understand deployment options
• Compile-Time Power — MetaScript's killer feature