Skip to content

Tooling

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.

PageWhat it covers
Installing NomiFrom source, With go install, What Nomi needs besides itself, Windows
CommandsThe nomi command, Running a program, Scripts: nomi <file>, The REPL, Checking: nomi check, Tools: nomi tool, TypeScript types: nomi types, The artifact cache
ProjectsStarting a project: nomi new and nomi init, nomi.toml and go.mod, Project mode, Project root discovery, [i18n], [money]
Modules and dependenciesAdd, update and remove dependencies, Dependencies, Distribution, No lock file
Running testsFinding and selecting tests, nomi test --watch, Timeouts, Output, Line diffs, JSON Lines, The test environment
Formattingnomi 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.
BuildingExecutables, 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 bindingsThe Go toolchain
When code cannot run yetA program that reaches a function the compiler cannot compile yet fails before its first effect.
Environment variablesThese variables change what nomi does.
Editors and debuggerThe language server, Coding agents: nomi mcp, Debugging, Embedded files in the editor, Phrase catalogs in the editor