Batch Claude Runner
Runs Claude against batches of files, collecting structured findings into a summary report.
Quick Start
# Basic usage
python .claude/skills/batch-claude-runner/scripts/batch_claude_runner.py \
--pattern "**/*.py" \
--prompt "Check for hardcoded credentials or API keys."
# See all options
python .claude/skills/batch-claude-runner/scripts/batch_claude_runner.py --help
Key Options
--pattern/-p: Glob pattern for files (required, repeatable)--exclude/-e: Exclude pattern (repeatable)--prompt: Analysis prompt--batch-size/-b: Files per batch (default: 10)--max-batches/-m: Limit batches (for testing)--dry-run: Preview files without running--output json: Machine-readable output
Notes
- Claude reads files via its Read tool and can make edits if prompted
- Structured JSON output is enforced automatically via
--json-schema - Use
--dry-runfirst to verify file selection