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 a remote ullama server (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 = Qwen3 1.7B qwen-overviews = Qwen3.5 2B granite-medium = Granite 4.1 3B gemma-balanced = Gemma 4 E2B gemma-accurate = Gemma 4 E4B qwen-large = Qwen3.5 9B gemma-large = Gemma 4 12B qwen-workstation = Qwen3.6 35B-A3B [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 granite-medium someDatabase.und
und ai -searchindex someDatabase.und
und ai -searchindex -all someDatabase.und