add quiet option

Author: Frotty

src/main/kotlin/file/CLICommand.kt

@@ -56,6 +56,11 @@ enum class GlobalOptions(val optionName: String = "", val argCount: Int = 0) {
             setupMain.addGithubWorkflow = false
         }
     },
+    QUIET("--quiet") {
+        override fun runOption(setupMain: SetupMain, args: List<String>) {
+            setupMain.quiet = true
+        }
+    },
     SCRIPT_MODE("--script-mode", 1) {
         override fun runOption(setupMain: SetupMain, args: List<String>) {
             setupMain.scriptMode = when (args[0].lowercase()) {

src/main/kotlin/file/SetupApp.kt

@@ -94,6 +94,9 @@ object SetupApp {
                     |    --with-ci / --no-ci            Include GitHub Actions workflow (default: no)
                     |  test [filter]                    Run unit tests, optionally filtered by package/function name
                     |  typecheck                        Typecheck the project without building a map
+                    |
+                    |Global options:
+                    |  --quiet                          Suppress wurst output; only print errors and final result
                     |  outdated                         Check whether project dependencies are up to date
                     |  build <mapfile>                  Build the project using the given input map
                 """.trimMargin())
@@ -149,12 +152,14 @@ object SetupApp {
 			}
             setup.command == CLICommand.TEST -> {
                 log.info("⚗️ Testing project..")
+                if (!setup.quiet) log.info("💡 Tip: run with --quiet to suppress compiler output and only show errors (useful for AI agents).")
                 if (InstallationManager.status != InstallationManager.InstallationStatus.NOT_INSTALLED && configData != null) {
                     testProject(configData)
                 }
             }
             setup.command == CLICommand.TYPECHECK -> {
                 log.info("🔍 Typechecking project..")
+                if (!setup.quiet) log.info("💡 Tip: run with --quiet to suppress compiler output and only show errors (useful for AI agents).")
                 if (InstallationManager.status != InstallationManager.InstallationStatus.NOT_INSTALLED && configData != null) {
                     typecheckProject(configData)
                 }
@@ -320,6 +325,21 @@ object SetupApp {
 
     private fun startWurstProcess(args: ArrayList<String>): Int {
         val pb = ProcessBuilder(args)
+        if (setup.quiet) {
+            pb.redirectErrorStream(true)
+            val p = pb.start()
+            val output = p.inputStream.bufferedReader().readLines()
+            val exitCode = p.waitFor()
+            val errorLines = output.filter { line ->
+                line.contains("error", ignoreCase = true) ||
+                line.contains("Error", ignoreCase = true) ||
+                line.contains("warning", ignoreCase = true) ||
+                line.contains("FAILED", ignoreCase = true) ||
+                line.contains("Exception", ignoreCase = true)
+            }
+            errorLines.forEach { println(it) }
+            return exitCode
+        }
         pb.redirectOutput(Redirect.INHERIT)
         pb.redirectError(Redirect.INHERIT)
         val p = pb.start()

src/main/kotlin/file/SetupMain.kt

@@ -22,6 +22,8 @@ class SetupMain {
 
     var noPJass = false
 
+    var quiet = false
+
     // Generate wizard options (defaults: non-interactive, Lua, Reforged, no extras)
     var addAgents: Boolean = false
     var addGithubWorkflow: Boolean = false

templates/AGENTS.md

@@ -25,11 +25,21 @@ to add and pull a specific Git dependency.
 After making Wurst changes, always run:
 
 ```bash
-grill typecheck
+grill typecheck --quiet
 ```
 
+The `--quiet` flag suppresses verbose compiler output and only prints errors — use it to keep context small. Without it, the compiler emits a large amount of output that wastes context window space.
+
 Fix reported errors and relevant warnings before considering the task done.
 
+When running tests:
+
+```bash
+grill test --quiet
+```
+
+Same rule applies: `--quiet` filters output to errors only and prints `✔ All tests succeeded.` on success.
+
 ## Project configuration (`wurst.build`)
 
 `wurst.build` is a YAML file at the repository root that controls project metadata, dependencies, and map build settings. It is the source of truth for:
@@ -474,7 +484,7 @@ Hot doc comments:
 
 ## Common pitfalls
 
-* Always run `grill typecheck` after code changes.
+* Always run `grill typecheck --quiet` after code changes.
 * Do not commit `_build/` or edit `_build/dependencies/` as source.
 * Wurst code must be inside `package`.
 * Indentation defines blocks.