DocsInstallReference

Docs

Learn Musi by writing Musi.

Start with files and packages, then move through expressions, data, effects, types, abstractions, and the toolchain.

Start readingInstall firstReference

Table of contents

Chapter groups

Source

Start

Getting started

Install, PATH setup, and the difference between musi and music.

First program

A first Musi file without extra ceremony.

Files, packages, and entry

Packages, musi.json, and the resolved entry file.

Core language

Expressions and bindings

The base reading model for names, sequences, and branching.

Functions and calls

Functions, calls, and recursion without extra control syntax.

Imports and packages

Import expressions, @std, and the musi:* foundation namespace.

Data and pattern matching

Data definitions, constructors, and pattern matching.

Records and arrays

Structured values and the current writeable-data surface.

Effects

Effects and handlers

The main Musi differentiator, shown with real syntax.

Types

Types and generics

Type annotations, generic parameters, and direct type application.

Abstractions

Classes and instances

Classes, methods, and instance declarations.

Attributes and foreign declarations

Public attributes, foreign bindings, and symbol metadata.

Quote and syntax values

Quoted expressions, quoted blocks, and splice forms.

Tooling

Foundation and standard library

The standard library family and the lower-level foundation namespace.

Testing and running

The main commands for package work and direct file work.

github.com/musi-lang/musi

musi-lang.com