Merge pull request #12 from webcoyote/add-quiet-flag

Add -q/--quiet flag to suppress output on success

Author: ldomaradzki

CLAUDE.md

@@ -41,6 +41,10 @@ swift test 2>&1 | xcsift
 # Print detailed warnings list (by default only warning count is shown in summary)
 swift build 2>&1 | xcsift --print-warnings
 xcodebuild build 2>&1 | xcsift --print-warnings
+
+# Quiet mode - suppress output when build succeeds with no warnings or errors
+swift build 2>&1 | xcsift --quiet
+xcodebuild build 2>&1 | xcsift -q
 ```
 
 ## Architecture
@@ -99,4 +103,5 @@ The tool outputs structured data optimized for coding agents:
 - **JSON**: Structured format with `status`, `summary`, `errors`, `warnings` (optional), `failed_tests`
   - **Summary always includes warning count**: `{"summary": {"warnings": N, ...}}`
   - **Detailed warnings list** (with `--print-warnings` flag): `{"warnings": [{"file": "...", "line": N, "message": "..."}]}`
-  - **Default behavior** (without flag): Only shows warning count in summary, omits detailed warnings array to reduce token usage
+  - **Default behavior** (without flag): Only shows warning count in summary, omits detailed warnings array to reduce token usage
+  - **Quiet mode** (with `--quiet` or `-q` flag): Produces no output when build succeeds with zero warnings and zero errors

Sources/main.swift

@@ -15,7 +15,7 @@ struct XCSift: ParsableCommand {
     static let configuration = CommandConfiguration(
         commandName: "xcsift",
         abstract: "A Swift tool to parse and format xcodebuild output for coding agents",
-        usage: "xcodebuild [options] 2>&1 | xcsift [--warnings|-w] [--version|-v] [--help|-h]",
+        usage: "xcodebuild [options] 2>&1 | xcsift [--warnings|-w] [--quiet|-q] [--version|-v] [--help|-h]",
         discussion: """
         xcsift reads xcodebuild output from stdin and outputs structured JSON.
 
@@ -27,6 +27,7 @@ struct XCSift: ParsableCommand {
           xcodebuild test 2>&1 | xcsift -w
           swift build 2>&1 | xcsift --warnings
           swift test 2>&1 | xcsift
+          swift build 2>&1 | xcsift --quiet
         """,
         helpNames: [.short, .long]
     )
@@ -37,6 +38,9 @@ struct XCSift: ParsableCommand {
     @Flag(name: [.short, .long], help: "Print detailed warnings list (by default only warning count is shown)")
     var warnings: Bool = false
 
+    @Flag(name: [.short, .long], help: "Suppress output when build succeeds with no warnings or errors")
+    var quiet: Bool = false
+
     func run() throws {
         if version {
             print(getVersion())
@@ -57,7 +61,7 @@ struct XCSift: ParsableCommand {
         }
 
         let result = parser.parse(input: input, printWarnings: warnings)
-        outputResult(result)
+        outputResult(result, quiet: quiet)
     }
 
     private func readStandardInput() -> String {
@@ -76,7 +80,11 @@ struct XCSift: ParsableCommand {
         }
     }
 
-    private func outputResult(_ result: BuildResult) {
+    private func outputResult(_ result: BuildResult, quiet: Bool) {
+        // In quiet mode, suppress output if build succeeded with no warnings or errors
+        if quiet && result.status == "success" && result.summary.warnings == 0 {
+            return
+        }
         outputJSON(result)
     }