Read Ue Logs

read-ue-logs

Quick start

From the project root, run:

powershell -NoProfile -File .claude/skills/read-ue-logs/scripts/read-logs.ps1 -Tail 50

By default this scans Saved/Logs/.log plus any Saved/Logs/_N.log modified in the last 10 minutes, merges them by timestamp, and prints the last 50 lines. The script auto-locates the project root and project name from the nearest *.uproject, so the working directory does not need to be the repo root. Use pwsh -File ... instead of powershell -File ... if PowerShell 7+ is installed (both editions are supported).

> Running UE automation tests? Run them through a test MCP server — osseous/ue-headless-mcp (preferred) or remiphilippe/mcp-unreal — (run_tests / run_visual_tests) and take the first read of the result from its get_test_log. Reach for this skill when one log isn't enough — merging concurrent editor + standalone-client logs into one timeline, filtering by category/verbosity/source, or grepping across a whole session.

Workflows

Diagnose a failure after a repro

# Recent errors only
powershell -NoProfile -File .claude/skills/read-ue-logs/scripts/read-logs.ps1 -Verbosity Error -Tail 100

# Blueprint-specific output
powershell -NoProfile -File .claude/skills/read-ue-logs/scripts/read-logs.ps1 -Category LogBlueprint -Tail 100

# Hunt for a specific keyword (regex)
powershell -NoProfile -File .claude/skills/read-ue-logs/scripts/read-logs.ps1 -Search "MyActor|Spawn"

Analyze a multi-client test run

When multiple instances run (editor + standalone clients), UE writes .log, _2.log, _3.log etc. Default behavior merges all of them and prefixes each line with [].

# All clients, last 10 min, merged and prefixed
powershell -NoProfile -File .claude/skills/read-ue-logs/scripts/read-logs.ps1 -Tail 200

# Isolate one client (substitute your actual project name)
powershell -NoProfile -File .claude/skills/read-ue-logs/scripts/read-logs.ps1 -Source MyProject_2

Programmatic consumption

powershell -NoProfile -File .claude/skills/read-ue-logs/scripts/read-logs.ps1 -Format json -Tail 50

Each line is one JSON object: {source, line, timestamp, thread, category, verbosity, message}.

Advanced features

• -RecentMinutes — change the auto-discovery window (default 10). Pass a large value to merge older sessions; if nothing matches the window, the script falls back to the single most-recent log so it never returns empty.
• -LogFile — point at one specific log file, bypassing auto-discovery. Pass -LogFile all to include rotated -backup-*.log files too.
• -ProjectName — override the auto-detected project name for unusual setups (renamed logs, multi-uproject monorepos).
• Exit codes: 0 on success (even with zero matches), 1 only on a missing log directory or script error.
• The editor does not need to be running — the script reads files on disk.

See [README.md](README.md) for the full flag reference, the multi-file model, and notes on extending the parser.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: osseous
• Source: osseous/skills
• License: MIT

Install and usage instructions live in the source repository linked above.