und is the command-line interface to Understand — script project creation, analysis, CodeCheck, metrics, and reports, locally or in CI.
Run Understand from the command line · Headless workflow: create, analyze, check, report
AI
uses local AI to describe the project and build the AI code search index
Mode (choose one; default is -overviews)
| Option | Description |
|---|---|
-overviews | Generate AI descriptions for functions, classes, files, and architectures (default when no mode is specified) |
-searchindex | Build or update the AI Code Search semantic index |
Arguments that apply to either mode
| Option | Description |
|---|---|
-all | Regenerate/rebuild everything, overwriting existing data |
-changed | Process only what is new or out of date (default) |
-server | Host and port for undaiserver (example: 123.123.123.123:56767) |
Arguments for -overviews only
| Option | Description |
|---|---|
-exitstatus | Exit with an error code if any descriptions failed |
-model | Set the AI model for Understand AI. Available models:qwen-fast = qwen 3 1.7B parameter qwen-medium = qwen 3 4B parameter qwen-accurate = qwen 3 8B parameter granite-medium = granite 4 micro (3B parameter) [path] = specify the path to a custom gguf model |
Using the global -verbose option will show each description as it is generated (applies to -overviews only).
Example usage
und ai someDatabase.und
und ai -overviews -all -verbose -model medium someDatabase.und
und ai -searchindex someDatabase.und
und ai -searchindex -all someDatabase.und