This reference covers the nomi command and the files around a program: the commands and their flags, nomi.toml, modules and dependencies, the test runner, what each kind of build writes, Go bindings, environment variables, and the editor and debugger support. What the language does is in the specification, and the standard library’s types and functions are in the standard library reference. To install nomi, see Installing Nomi.
These pages are generated from docs/tooling.md and docs/install.md in the repository.
| Page | What it covers |
|---|
| Installing Nomi | From source, With go install, What Nomi needs besides itself, Windows |
| Commands | The nomi command, Running a program, Scripts: nomi <file>, The REPL, Checking: nomi check, Tools: nomi tool, TypeScript types: nomi types, The artifact cache |
| Projects | Starting a project: nomi new and nomi init, nomi.toml and go.mod, Project mode, Project root discovery, [i18n], [money] |
| Modules and dependencies | Add, update and remove dependencies, Dependencies, Distribution, No lock file |
| Running tests | Finding and selecting tests, nomi test --watch, Timeouts, Output, Line diffs, JSON Lines, The test environment |
| Formatting | nomi fmt [-w|-l|-d|-check] <paths> formats Nomi source: -w writes the result to each file, -l lists the files that would change, and -d shows a diff. |
| Building | Executables, Embedded files, Frontend builds, Capability classes, Compiled programs and nomi-vm, A program in the browser, Calling exported functions, A program’s locale data |
| Go bindings | The Go toolchain |
| When code cannot run yet | A program that reaches a function the compiler cannot compile yet fails before its first effect. |
| Environment variables | These variables change what nomi does. |
| Editors and debugger | The language server, Coding agents: nomi mcp, Debugging, Embedded files in the editor, Phrase catalogs in the editor |