peekie-errors

peekie errors

List every build error in a .xcresult bundle as a flat sorted JSON array (or human-readable list). Same shape as peekie warnings.

Synopsis

peekie errors <xcresult-path> [flags]

Flags

Flag	Default	Notes
<xcresult-path>	—	Required positional. Path to the .xcresult bundle.
--format json|list	json	Output format.
-v, --verbose	false	Debug-level logging to stderr.

There is no --include flag on peekie errors. Filter with jq.

Output shape

--format json (default)

Flat sorted array, one entry per error:

[
  {"file": "AppDelegate.swift", "line": 87, "column": 5, "type": "Swift Compiler Error", "message": "Cannot find 'FooBar' in scope"},
  {"file": "Network/Client.swift", "line": 154, "column": 12, "type": "Swift Compiler Error", "message": "Value of type 'URLSession' has no member 'asyncData'"}
]

• line / column are null when xcresult didn't emit them.
• type is the raw Apple issueType string — most commonly Swift Compiler Error, but anything in the errors bucket appears here.

Note: unlike peekie warnings, you should not see #warning(...) markers here — those land in peekie warnings even though Apple tags them Swift Compiler Error (see peekie-warnings).

--format list

One line per error, grouped by file.

Recipes

Fail CI on any error

errors=$(peekie errors Build.xcresult | jq 'length')
if [ "$errors" -gt 0 ]; then
  peekie errors Build.xcresult --format list
  exit 1
fi

Print first three errors with file:line

peekie errors Build.xcresult \
  | jq -r '.[:3] | .[] | "\(.file):\(.line // "?"): \(.message)"'

Group errors by file

peekie errors Build.xcresult | jq 'group_by(.file) | map({file: .[0].file, count: length})'

Just the first error's message (handy for build-failure notifications)

peekie errors Build.xcresult | jq -r '.[0].message // "no errors"'