Tools · Diagnostics

Diagnostic tools

Run linters, the TypeScript compiler, and Mako's own rule pack on a bounded set of files. Results persist into Reef so the agent can query them later via file_findings and project_open_loops.

lint_files write

Mako's internal diagnostics for a bounded file set. TS-aware, structural, plus Mako's own rule pack.

Input

{
  "files": ["app/dashboard/manager/layout.tsx", "lib/auth/dal.ts"],
  "maxFindings": 100
}

Findings persist as Reef rows with a matchBasedId fingerprint — usable with finding_ack.

typescript_diagnostics write

Run TSC and persist Reef diagnostic run/finding rows.

When to use it

After type-affecting edits. Compare before/after counts to know whether your refactor introduced new TS errors.

eslint_diagnostics write

Run local ESLint on requested files. Persists to Reef.

oxlint_diagnostics write

Run local Oxlint on requested files (if installed). Faster than ESLint on large codebases.

biome_diagnostics write

Run local Biome checks on requested files (if Biome is configured).

diagnostic_refresh write

Invoke selected diagnostic sources and record compact per-source Reef results.

When to use it

Routine "rebuild the diagnostic snapshot" after big edits.

git_precommit_check write

Check staged TS/TSX files for route auth and Next.js client/server boundary mistakes.

When to use it

Before git commit on auth-sensitive or boundary-sensitive changes. Useful as a pre-commit hook.

project_diagnostic_runs read

Read previous diagnostic run status without rerunning. Tells you the freshness of the cached diagnostic state.