uloop-get-logs · diff
git:20260622.7b7ead4 to git:20260711.6daa84f
0 added, 22 removed. Audit A to A.
---
name: uloop-get-logs
toolName: get-logs
description: "Read current Unity Console entries from a running Editor. Use during bug investigation after compile, tests, PlayMode, dynamic code, or immediately after `uloop-wait-for-pause-point`."
---
# uloop get-logs
Retrieve logs from Unity Console.
## Usage
```bash
uloop get-logs [options]
```
## Parameters
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `--log-type` | string | `All` | Log type filter: `Error`, `Warning`, `Log`, `All` |
| `--max-count` | integer | `100` | Maximum number of logs to retrieve |
| `--search-text` | string | - | Text to search within logs |
| `--include-stack-trace` | flag | - | Include stack trace in output |
| `--use-regex` | flag | - | Use regex for search |
| `--search-in-stack-trace` | flag | - | Search within stack trace |
- ## Global Options
-
- | Option | Description |
- |--------|-------------|
- | `--project-path <path>` | Optional. Use only when the target Unity project is not the current directory. |
-
- ## Examples
-
- ```bash
- # Get all logs
- uloop get-logs
-
- # Get only errors
- uloop get-logs --log-type Error
-
- # Search for specific text
- uloop get-logs --search-text "NullReference"
-
- # Regex search
- uloop get-logs --search-text "Missing.*Component" --use-regex
- ```
-
## Output
Returns JSON with:
- `TotalCount` (number): Total logs available before max-count clipping
- `DisplayedCount` (number): Logs returned in this response (≤ `--max-count`)
- Input filters (`LogType`, `MaxCount`, `SearchText`, `IncludeStackTrace`) are echoed back in the response
- `Logs` (array): Each entry has:
- `Type` (string): `"Error"`, `"Warning"`, or `"Log"`
- `Message` (string): Log message body
- `StackTrace` (string): Stack trace text. Empty when `--include-stack-trace` is `false`.