nat-n/poethepoet

Health v2 · maintenance only

Adoption not part of the score

2064 stars · 80 forks observed · 2026-08-28

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

Poe the Poet is a task runner for Python projects that lets you declare tasks in pyproject.toml and run them via a standalone CLI or as a poetry plugin, executing in your project's virtualenv. It supports commands, shell scripts, Python expressions, task composition (sequences, parallel, DAGs), CLI arguments, and env vars.

Use cases

• run project tasks defined in pyproject.toml
• replace make/tox with a python task runner
• run scripts inside poetry or uv virtualenv
• define named CLI arguments for project tasks
• compose tasks into sequences or parallel graphs
• use a task runner as a poetry plugin

When to choose

• you use poetry or uv and want tasks tied to the project virtualenv
• you want self-documenting tasks with shell completion
• you need task composition like sequences, parallel runs, or DAGs

When to avoid

• you need a general-purpose build system with dependency tracking like make
• your project is not Python-based or doesn't use pyproject.toml

Facets

cli-tool · maturity active

cli developer-tools workflow-automation plugin-system developer-tools python cli cross-platform task-runner poetry uv pyproject-toml poetry-plugin build-tasks command-line automation python

Member repositories

For agents

markdown · JSON · MCP: product_card(name="nat-n/poethepoet")