| name | pitchfork |
| description | Query code quality status from pitchfork background watchers (tests, lint, typecheck, format). Use when you want to check if tests pass, code is formatted, or lint is clean — without running checks manually. |
Pitchfork Quality Watchers
Background daemons that run code quality checks on file change. Check status instead of running commands manually.
Commands
pitchfork list
pitchfork logs <daemon> --raw -n 50
pitchfork logs --raw -n 30
pitchfork logs <daemon> --raw --since 5min
pitchfork start --all
pitchfork restart <daemon>
pitchfork stop --all
pitchfork logs --clear
Daemons are defined in pitchfork.toml at project root.
Interpreting Output
Empty output = clean. No lines means last run passed.
Otherwise read raw logs directly:
- Test runners:
FAIL/PASS summary at bottom
- Linters: error count, issues by file
- Type checkers:
error TS... lines
- Format checkers: lists files needing formatting
Workflow
- Make changes
pitchfork logs <daemon> --raw --since 5min
- Fix issues if found (watchers auto re-run on file change)
- Commit when green
Always use --since to avoid stale errors from previous runs. Clear history with --clear for fresh sessions.