python-poetry/cleo

Health v2 · maintenance only

Adoption not part of the score

1353 stars · 97 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Cleo is a Python library for building command-line interfaces with declarative commands, arguments, options, and styled terminal output. It is the CLI framework underlying Poetry and emphasizes testable command design.

Use cases

• build a cli tool in python
• parse command-line arguments and options
• add colored output to terminal commands
• write testable command-line commands
• create multi-command cli applications
• build a cli framework for a python package

When to choose

• you want a declarative, class-based cli framework in python
• you need styled terminal output with custom color styles
• testability of cli commands is a priority
• you are building tooling in the poetry ecosystem

When to avoid

• you want a minimal argparse-style standard library solution
• you need a mature, stable api - cleo is being rewritten for 3.0
• you are building guis or web apps rather than clis

Facets

library · maturity active

cli developer-tools developer-tools python cli cross-platform cli-framework command-line-interface terminal-output-styling testable-commands poetry-ecosystem command-line

Member repositories

For agents

markdown · JSON · MCP: product_card(name="python-poetry/cleo")