add CLI binary for conflict detection (v0.6.0)

.github/workflows/check.yml

@@ -28,6 +28,11 @@ jobs:
         run: |
           cd ${{ matrix.target }}
           cargo build --${{ matrix.build_type }}
+      - name: Build CLI
+        if: matrix.target == 'red4-conflicts'
+        run: |
+          cd red4-conflicts
+          cargo build --${{ matrix.build_type }} --features cli --no-default-features
       - name: Run tests
         run: |
           cd ${{ matrix.target }}

.github/workflows/release.yml

@@ -31,6 +31,11 @@ jobs:
         run: |
           cd ${{ matrix.target }}
           cargo build --${{ matrix.build_type }}
+      - name: Build CLI
+        if: matrix.target == 'red4-conflicts'
+        run: |
+          cd red4-conflicts
+          cargo build --${{ matrix.build_type }} --features cli --no-default-features
       - name: Run tests
         run: |
           cd ${{ matrix.target }}
@@ -42,12 +47,31 @@ jobs:
           name: ${{ matrix.target }}
           path: ${{ matrix.target }}/target/${{ matrix.build_type }}/${{ matrix.target }}.exe
 
+      - name: Upload CLI Artifact
+        if: matrix.target == 'red4-conflicts'
+        uses: actions/upload-artifact@v4
+        with:
+          name: red4-conflicts-cli
+          path: red4-conflicts/target/${{ matrix.build_type }}/red4-conflicts-cli.exe
+
       - name: zip
         run: Compress-Archive -Path "${{ matrix.target }}/target/${{ matrix.build_type }}/${{ matrix.target }}.exe" -DestinationPath "${{ matrix.target }}.zip"
 
+      - name: zip CLI
+        if: matrix.target == 'red4-conflicts'
+        run: Compress-Archive -Path "red4-conflicts/target/${{ matrix.build_type }}/red4-conflicts-cli.exe" -DestinationPath "red4-conflicts-cli.zip"
+
       - name: Upload to release
         uses: ncipollo/release-action@v1
         with:
           artifacts: "${{ matrix.target }}.zip"
           allowUpdates: true
           tag: "latest"
+
+      - name: Upload CLI to release
+        if: matrix.target == 'red4-conflicts'
+        uses: ncipollo/release-action@v1
+        with:
+          artifacts: "red4-conflicts-cli.zip"
+          allowUpdates: true
+          tag: "latest"

README.md

@@ -8,12 +8,41 @@ Some utility tools for Cyberpunk 2077 modding.
 
 > Nexus Mods link: https://www.nexusmods.com/cyberpunk2077/mods/11126
 
-A conflict-checker app for Cyberpunk 2077 archives.
+A conflict-checker app for Cyberpunk 2077 archives. Available as both a GUI app and a headless CLI tool.
 
-### Usage
+### Using the GUI
 - download and extract
 - run `red4-conflicts.exe` and specify a folder with archives to check
 
+### Using the CLI
+
+The CLI outputs structured JSON for use with LLMs or other tools. It auto-detects your game installation (Steam/GOG).
+
+```cmd
+Usage: red4-conflicts-cli.exe [OPTIONS] [ARCHIVE_PATH]
+
+Options:
+      --pretty                  Pretty-print the JSON output
+      --toon                    Output in TOON format (experimental, fewer tokens for LLM input)
+      --summary                 Compact overview instead of full report
+      --mod-filter <PATTERN>    Filter archives by name (supports regex)
+      --file-filter <PATTERN>   Filter files by path (supports regex)
+      --show-no-conflicts       Include non-conflicting files
+      --show-load-order         Include the full load order list
+  -h, --help                    Print help
+```
+
+```cmd
+# Get a summary of all conflicts
+red4-conflicts-cli --summary --pretty
+
+# Filter for a specific mod
+red4-conflicts-cli --mod-filter "ArchiveXL" --pretty
+
+# Save full report to file
+red4-conflicts-cli --pretty > conflicts.json
+```
+
 ### Screenshots
 ![screenshot](./assets/red4_conflicts_02.png)