# logs Recent console output from the running app (what the devtools console shows: page logs, worker logs, uncaught errors), oldest first. The app buffers the last 2000 entries across reloads and project switches, so this replaces relaunching with ELECTRON_ENABLE_LOGGING=1 when debugging renderer-side behavior. | | | | --- | --- | | MCP tool | `logs` | | CLI | `diffusion logs [options]` | ## Input | Field | Type | CLI | Description | | --- | --- | --- | --- | | `tail` | `integer` | `-n, --tail ` | return only the last n entries (default: 100) | | `level` | `"debug" \| "info" \| "warning" \| "error"` | `-l, --level ` | minimum level to include: debug, info, warning, or error | | `since` | `number` | `--since ` | only entries logged after this unix time in milliseconds; pass the last entry's `ts` to get only new ones | | `contains` | `string` | `-c, --contains ` | only entries whose message contains this (case-insensitive) | The buffer lives in the app's main process, so the log survives page reloads and project switches. Progress of long operations — an export's percentage, a generation landing — shows up here, so polling `logs` is how a caller follows work it started; pass `since` with the last `ts` seen so each poll returns only what is new. `level`, `since`, and `contains` filter first, then `tail` keeps the last entries of what is left. A message longer than 4000 characters is cut, ending in `… (N more chars)`. ## Output One JSON object, the entries oldest first: ```ts { entries: Array<{ ts: number; // unix time, milliseconds level: "debug" | "info" | "warning" | "error"; message: string; source: string; // file:line the entry came from (a URL in dev builds); empty for synthetic entries such as renderer crashes and preload errors }>; } ``` ## Errors Fails when `tail` is not a positive integer, `level` is not one of the four levels, or `contains` is empty.