lis is the Lisette compiler toolchain, which provides every command below.
Create a new Lisette project in the current directory.
Directory Directory Argument Does project-name (required)Name of the project, e.g. hello-world
Packages
lis run [target] [--flags]
Compile a Lisette project to a binary at target/bin/ and run the binary.
Argument Does target (optional)Project dir or file (default: current dir)
Flag Does --sourcemapInclude //line in Go code for stack traces --go-flags "<flags>"Pass flags through to go build
Example Does lis runRun project in current dir lis run ~/projects/demoRun project in specific dir lis run calculate.lisRun a script lis run greet.lis johnPass argument to script lis run --go-flags "-ldflags='-s -w'"Pass linker flags to go build
Scripts
lis build [path] [--flags]
Compile a project to a binary at the target/.lisette/bin/ dir.
Argument Does path (optional)Path to project dir or file (default: current dir)
Flag Does --sourcemapInclude //line in Go code for stack traces --go-flags "<flags>"Pass flags through to go build -o, --output <path>Write the binary for a script at this path
Example Does lis buildBuild project in current dir lis build ~/projects/demoBuild project in specific dir lis build greet.lisBuild a script to ./greet lis build greet.lis -o bin/greetBuild a script to a chosen path lis build --go-flags "-trimpath"Strip file paths from the binary
lis emit [path] [--flags]
Generate Go code from a Lisette project at the target/ dir.
Argument Does path (optional)Path to project dir or file (default: current dir)
Flag Does --sourcemapInclude //line in Go code for stack traces -o, --output <path>Write the Go file for a script at this path
Example Does lis emitEmit Go for project in current dir lis emit ~/projects/demoEmit Go for project in specific dir lis emit greet.lisEmit a script to ./greet.go
lis check [path] [--flags]
Lint and typecheck a Lisette project.
Argument Does path (optional)Path to dir (default: current dir)
Flag Does --errors-onlyShow only errors --warnings-onlyShow only warnings --deny warningsFail check if warnings found --fixApply lint fixes in place --output unixMachine-readable output
Example Does lis checkCheck project in current dir lis check ~/projects/demoCheck project in specific dir lis check script.lisCheck single file lis check --fixFix all lints in the project lis check --output unixOne diagnostic per line
lis format [path] [--flags]
Format source files in a Lisette project.
Argument Does path (optional)Path to file or dir (default: current dir)
Flag Does --checkVerify formatting without modifying files
Example Does lis formatFormat project in current dir lis format ~/projects/demoFormat project in specific dir lis format src/main.lisFormat a single file lis format --checkVerify formatting in current dir
lis test [path] [--flags]
Run tests in a Lisette project.
Argument Does path (optional)Path to dir (default: current dir)
Flag Does -f, --filter <pattern>Run only tests whose name contains pattern --failedRerun the tests that failed last time --go-flags "<flags>"Pass flags through to go test
Example Does lis testRun all tests in current dir lis test ~/projects/demoRun tests in specific dir lis test -f parseOnly tests whose name contains “parse” lis test --go-flags "-failfast"Stop at the first failing test
Tests
lis add <dependency>[@version] [--flags]
Add a third-party Go module as a dependency to your project or script.
Argument Does dependency (required)Go module name
Flag Does --replace <module>Redirect to another module --path <dir>Add a local Go module --script <file>Add to this script
Example Does lis add google/uuidLatest version lis add google/uuid@v1.6.0Exact version lis add google/uuid@2d3c2a9Exact commit hash or branch lis add go.uber.org/zapFull path for non-GitHub host lis add --path ../authUse the Go module at ../auth lis add gorilla/mux --replace you/muxUse your own fork of gorilla/mux lis add --script tool.lis google/uuidAdd google/uuid to a script
Third-party Go modules and Go module overrides
Reconcile lisette.toml against the go: imports in src/, similar to go mod tidy. This drops dependency entries no longer reached by any import, and generates typedefs for every imported package. Run this after removing imports, deleting source files, or pulling new code.
Flag Does --script <file>Tidy this script’s dependencies
Example Does lis syncTidy the project in the current dir lis sync --script tool.lisTidy a script’s dependencies
Third-party Go modules
Print compiler version (Lisette and Go toolchain).
Upgrade the compiler, or show the upgrade command for the tool that installed it.
Show help for a command.
Argument Does command (required)Command to get help for (e.g. run, build)
lis doc [symbol] [--flags]
Browse documentation on a symbol from the prelude or from the Go stdlib.
Argument Does symbol (optional)Symbol to look up (omit to list all)
Flag Does -s, --search <term>Search docs for term
Example Does lis docList prelude symbols and Go packages lis doc SliceDocs on Lisette’s Slice type lis doc Slice.mapDocs on map method on Lisette’s Slice type lis doc preludeList all Lisette prelude symbols lis doc testHow to write and run tests lis doc go:List all Go stdlib packages lis doc go:osDocs on Go stdlib os package contents lis doc go:os.FileDocs on File type in Go stdlib os package lis doc -s appendSearch docs for append
Prelude
Create a sample Lisette project in the current directory.
Directory Directory Directory Directory Directory Directory The sample is a CLI task manager that demonstrates enums, structs, pattern matching, error handling, closures, Go interop, and concurrency.
Generate shell completion scripts.
Argument Does shell (required)Shell to generate completions for (bash, zsh, or fish)
lis complete bash > ~/.local/share/bash-completion/completions/lis
lis complete fish > ~/.config/fish/completions/lis.fish
For zsh, add to ~/.zshrc (before compinit):
Then generate:
mkdir -p ~/.zfunc && lis complete zsh > ~/.zfunc/_lis
Start the Lisette language server over stdio, for use by editor extensions.
LSP