How luau-lang/lute works
Lute is a standalone Luau runtime with a CLI and embedded Luau libraries. A typical user runs a Luau program through the CLI; the program can use runtime APIs for filesystem, networking, processes, and other general-purpose tasks, while tooling can inspect or manipulate Luau source. The README establishes the product capabilities, and sampled sources confirm the CLI entry point and selected network, filesystem, syntax, and debug behavior. Unsampled module registration and several subsystem call relationships are intentionally not inferred.
Main entry points: runtime.cpp Runtime core · climain.cpp CLI commands · net.cpp Networking · main.cpp CLI entry
Components 21
Execution
- CLI entry
lute/cli/src/main.cpp - CLI commands
lute/cli/src/climain.cpp - Compile
lute/cli/src/compile.cpp - Package run
lute/cli/src/packagerun.cpp
Runtime APIs
- Runtime core
lute/runtime/src/runtime.cpp - Module require
lute/require/src/require.cpp - Filesystem
lute/fs/src/fs.cpp - Networking
lute/net/src/net.cpp - HTTP client
lute/net/src/httpclient.cpp - WebSocket client
lute/net/src/wsclient.cpp - HTTP server
lute/net/src/server.cpp - Processes
lute/process/src/process.cpp - System APIs
lute/system/src/system.cpp - I/O APIs
lute/io/src/io.cpp - Time APIs
lute/time/src/time.cpp
Luau Libraries
- Standard library
lute/std/src/stdlib.cpp - Batteries
lute/batteries/src/clibatteries.cpp
Developer Tooling
- Syntax parser
lute/syntax/src/parser.cpp - Type serialization
lute/luau/src/type.cpp - Debugger
lute/debug/src/debuginternals.cpp
Other components
- Luau user
Connections 20
- Luau user → CLI entry: runs program
- CLI entry → CLI commands: dispatches to
- CLI commands → Compile: compiles
- CLI commands → Package run: runs package
- CLI commands → Runtime core: executes with
- Runtime core → Module require: loads modules
- Runtime core → Filesystem: exposes file APIs
- Runtime core → Networking: exposes network APIs
- Networking → HTTP client: provides client
- Networking → WebSocket client: provides client
- Networking → HTTP server: provides server
- Runtime core → Processes: exposes process APIs
- Runtime core → System APIs: exposes system APIs
- Runtime core → I/O APIs: exposes I/O APIs
- Runtime core → Time APIs: exposes time APIs
- Runtime core → Standard library: embeds library
- Runtime core → Batteries: embeds libraries
- Luau user → Syntax parser: uses tooling
- Luau user → Type serialization: uses tooling
- Luau user → Debugger: debugs programs