Lint

---
name: lint
description: Use when finding and fixing the project's configured lint findings in the current session, without a separate MEOW fixer agent.
---

# lint

Runs the project's `[[lint]]` commands and has **you** — this session — fix what
they report, using `meow native lint` for the facts. Read
[`../_shared/native-mode.md`](../_shared/native-mode.md) for helper conventions. Never run plain
`meow run --lint-fix` here: that spins up meow's own fixer agent, duplicating
your work and racing your edits. Dependency or install problems: [dependencies](../_shared/dependencies.md).

## Native mode

1. The project needs `.meow/config.toml` with at least one `[[lint]]` entry;
otherwise tell the user and stop (point at `docs/INTEGRATIONS.md` for the
`[[lint]]` schema, or invoke `/meow:onboard` to configure it).
2. Run `meow native prepare --no-worktree --allow-dirty --work-dir "<project-path>"`
   for `max_rounds` and `docs_dir`, then
   `meow native round <docs_dir>/lint-fix.md --reset --work-dir "<project-path>"`.
3. Auto-fix pass, then check: `meow native lint --fix --all-blocking --work-dir "<project-path>"`.
   `--all-blocking` fixes every configured command unconditionally, matching
   `meow run --lint-fix`'s own CLI behavior -- `gate` only controls what fails a
   *review*, not what this skill leaves alone.
   - `"clean": true` -> report that nothing is left and stop.
   - Otherwise call `meow native round <docs_dir>/lint-fix.md --work-dir
     "<project-path>"` before the first manual fix attempt; stop if exhausted.
     Each entry in `blocking` is a `$ <command>` block of raw linter
     output. Before editing, run `meow native prompt lint-fixer --active-dir
     <active_dir> --work-dir "<project-path>"` and follow its returned `system_prompt`, just as the CLI
     lint-fixer role follows `lint_fixer_prompt`. Fix each finding yourself
     with the smallest edit that resolves it, without unrelated refactoring;
     run `meow native lint --file <path> --active-dir <active_dir>` after each
     edit. Do not launch another agent.
4. Re-check with `meow native lint --all-blocking --work-dir "<project-path>"`; call
   `meow native round <docs_dir>/lint-fix.md --work-dir "<project-path>"` before each further fix attempt
   and stop if it says `exhausted`.
5. Report the final outcome: clean, or what is still outstanding and why (e.g. a
   project-wide type error needing a design decision).

## CLI mode

Report-only, then fix by hand:

```bash
meow run --lint-fix --report-only --work-dir "<project-path>"
```

Exit 0 with `Lint is clean -- no issues found.` means done; otherwise fix each
`$ <command>` block it printed and re-run to confirm.