What problem does it solve?
Plankton prevents slow, error-prone code quality work by automatically formatting and linting files as they are edited, then using an LLM to remediate violations that can’t be fixed by standard tools.
Core Features & Use Cases
- Write-time enforcement via hooks: Runs auto-formatters and linters on every file edit using Gemini CLI PostToolUse hooks.
- Tiered LLM-based remediation: Delegates remaining violations to Haiku/Sonnet/Opus subprocesses based on complexity, then verifies the fixes by re-running the quality phases.
- Config tamper resistance: Blocks and detects attempts to game quality by modifying linter/formatter configuration files (e.g., Ruff/Biome configs).
- Package-manager guardrails: Blocks legacy package managers and enforces approved tooling to reduce environment drift.
- Multi-language coverage: Supports Python, TypeScript/JavaScript, Shell, YAML, Markdown, Dockerfile, TOML, and JSON.
Quick Start
Ask Gemini CLI to run Plankton hooks from within the Plankton directory so edits automatically trigger formatting, linting, and LLM-assisted fixes.