# Flutter Read Logs Usage

> Explain what the `flutter-read-logs` plugin does and how to use it. Use when the user invokes `/flutter-read-logs-usage`, asks what this plugin covers, or needs help setting up run-log capture for `/read-logs`.

- Skill: `leancodepl/flutter-read-logs-usage` (Agent Skill)
- Install (CLI): `npx skillmds@latest add leancodepl/flutter-read-logs-usage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/leancodepl/flutter-read-logs-usage/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: leancodepl (https://skillmd.com/u/leancodepl)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/leancodepl/flutter-read-logs-usage

---


# Read Logs Usage

## How to respond

- If the user invoked this skill without a concrete task, explain what the plugin does and when to reach for `/read-logs`.
- If they need setup, point them at this plugin's `README.md` (the canonical setup home) — VS Code/Cursor `dapLogFile`, or the Zed/`script` task.
- If they already have a concrete log-reading task, briefly explain the fit and then run `/read-logs`.
- Do not reply with filler like "skill loaded" or "ready for the task" before explaining the plugin.

## What this plugin does

- Lets Claude read the running app's latest `flutter run` output as on-demand context, via `/read-logs <task>` — instead of pasting terminal logs.
- Captures `flutter run` output per-project to `/tmp/flutter-<repo>.log` (worktree-stable via `--git-common-dir`, overwritten each launch). Two formats, auto-detected: Zed `script` transcript and VS Code/Cursor `dapLogFile` (DAP).
- Reads **task-led** — reads the whole short run, or investigates a long one against your question (errors, event ordering, a feature, …) — flags stale runs, and on first use guides editor setup.

## When to use it

- "Why did the app crash / behave like this at runtime?"
- "Does the auth flow actually reach the API?"
- "Trace the order these events fired" (races / timing).

## Setup

One-time per developer — full instructions in this plugin's `README.md` (VS Code/Cursor
`dapLogFile` keeps the F5 workflow; Zed uses a `script`-wrapped run task). `/read-logs` also
walks you through setup, and offers to apply it, the first time if no log file exists yet.

## Heads-up

Run logs can contain tokens and customer data, and `/read-logs` sends what it reads to the
model — see the caution in `README.md`.

## Related

- `flutter-marionette` — the **proactive** counterpart: *interact* with a live app via MCP.
  Reach for it to *make* things happen; reach for `/read-logs` to *inspect* what a run
  already logged (including crashes/build errors marionette can't see, since it needs a live
  connection).