refactor: use shared PRINTER singleton

[greysonlalonde]

Summary

• Replace all Printer() instantiations and _printer attributes/variables with the shared PRINTER singleton from utilities/printer.py
• Remove unnecessary PrivateAttr declarations, module-level variables, and ClassVar for Printer across 22 files
• Net deletion of 36 lines

Test plan

• All pre-commit hooks pass (ruff, ruff-format, mypy)
• Existing test suite passes unchanged

---

Note

Low Risk
Broad but mechanical refactor across executors/hooks/CLI to centralize printing; low functional risk, with main concern being any code that relied on per-instance printer state or test patching paths.

Overview
Standardizes console output by introducing a module-level PRINTER singleton in utilities/printer.py and migrating call sites to use it instead of constructing Printer() instances or storing _printer/_printer globals.

This removes multiple Printer attributes/PrivateAttr/ClassVar fields and updates error/verbose logging paths in executors, hooks, CLI commands, flow persistence/utils, and tool/LLM handling to pass PRINTER through to helper functions. Tests were adjusted to patch/mock PRINTER rather than mutating instance printers.

^{Reviewed by Cursor Bugbot for commit 22f02e7. Bugbot is set up for automated code reviews on this repo. Configure here.}

[iris-clawd]

Review: PRINTER singleton

Clean mechanical refactor. 22 files, net -37 lines, all Printer() / _printer / PrivateAttr(default_factory=Printer) replaced with PRINTER singleton.

✅ Approve

• Printer is stateless (just wraps print() with ANSI colors), so a singleton is the correct pattern — no shared mutable state concerns.
• Removes unnecessary PrivateAttr, ClassVar, and module-level _printer = Printer() instances across the codebase.
• Import path is consistent: from crewai.utilities.printer import PRINTER everywhere.
• Printer class is still exported for the few places that pass it as a parameter (e.g., handle_unknown_error(printer, ...)) — good, no breaking changes to function signatures.

No concerns. Ship it. ✅ 💬 177

[iris-clawd]

Re-approving after new commits. ✅

[iris-clawd]

Re-approving. ✅

[iris-clawd]

✅