mlld is a scripting language designed to make it delightful to work with LLMs in repeatable ways that would be onerous in a chat context.

Getting Started

The LLM-First Way

LLMs are quite skilled at writing mlld.

After npm install -g run mlld skill install and find the /mlld skills, which include common patterns.

You can also point your agent to mlld quickstart to get them up and running quickly. (Pairs well with skills; the skill tells them to run this.)

The Human Way

New to mlld? Start with the Introduction to learn the basic concepts and understand why mlld exists.

Ready to write code? The Quick Start gets you running in 5 minutes.

Reference

The reference sections cover every directive and configuration option:

• Core - Variables, templates, file loading, exe, run, builtins, escaping
• Flow Control - if, when, for, foreach, while, loop
• Effects - Pipelines, labels, guards, hooks
• Modules - Creating, importing, and publishing modules
• MCP - Export functions as tools, import external servers
• Output - output, log, append, stream
• CLI - Command line usage, checkpoint, validation
• Configuration - Config files, policy, environments, auth
• SDK - Execution modes, dynamic modules, static analysis
• Security - Signing, MCP security, audit logging
• Patterns - Prose, ralph, guarded tool export

Community

Join the Discord and ask questions.

If you encounter bugs, file a report on GitHub.