v0.46.0: 0.46.0

Compare Source

Enhancements

• Experimental Claude Code skill and bump-version task by @​nat-n in #​387
• Use AST parser for all templating by @​nat-n in #​386

Fixes

• Make uv and poetry executors check for bat files to handle shutdown quirks on windows by @​nat-n in #​385
• Strip underscore prefix in documentation for private positional args by @​nat-n in #​383
• Use AST for $POE_EXTRA_ARGS detection and cache parsed content by @​nat-n in #​388

Experimental agent skill

This release ships an experimental agent skill that gives AI coding agents contextual knowledge of poe's task API when working in projects that use it. It works with any agent that supports the skills convention and aims to improve agent abilities when it comes to leveraging and authoring poe tasks.

Please try it out and provide feedback!

Two install methods:

1. Via a built in poe task (similar to how shell completions are installed):

poe _install_skill                          # auto-detects .claude/.codex/.pi/.agents and prompts
poe _install_skill ~/.claude/skills         # explicit path (substitute your agent's dir)
poe _install_skill <skills-dir> --upgrade   # non-interactive upgrade (skips if same/newer)

2. From github via npx skills

npx skills add https://github.com/nat-n/poethepoet/tree/v0.46.0/poethepoet/skills/poethepoet

Full Changelog: nat-n/poethepoet@v0.45.0...v0.46.0

v0.45.0: 0.45.0

Compare Source

Enhancements

• Add support for forwarding free arguments via $POE_EXTRA_ARGS by @​timrid in #​380

Fixes

• Handle cancelled tasks correctly by @​timrid in #​378
• Preserve quotes in :+/:- operator arguments (#​333) by @​nat-n in #​377
• Handle ctrl+c attempt on windows if running bat/cmd scripts by @​NSPC911 in #​382

New Contributors

• @​timrid made their first contribution in #​378

Full Changelog: nat-n/poethepoet@v0.44.0...v0.45.0

v0.44.0: 0.44.0

Compare Source

Enhancements

• Add support for recursive include #​317 by @​nat-n in #​372

Breaking changes**

• Transitive includes are now loaded by default. Previously, if an included config file contained its own include entries, those second-order includes were silently ignored. They are now followed recursively using depth-first loading. This may cause previously ignored config files to be loaded, potentially introducing new tasks or environment variables. To preserve the old behavior for a specific include, set recursive = false on that include entry. See the include guide for details.

Full Changelog: nat-n/poethepoet@v0.43.0...v0.44.0

v0.43.0: 0.43.0

Compare Source

Enhancements

• Add task groups for grouping tasks under a heading in help output by @​brolewis in #​354
• Treat false boolean args as unset env vars and add private vars by @​kzrnm in #​359

Breaking changes

This release includes a refactor of how task variables are managed, improving boolean arg semantics and introducing private
variables. These changes may affect a small number of existing configurations:

• Boolean args now produce unset env vars when false. Previously false mapped to the string "False"; now the env var is removed entirely. This gives consistent falsy behavior across shells and parameter expansion operators (:-, :+). Tasks checking for the literal string "False" or using os.environ["flag"] will need updating.

• Private env vars are filtered from subprocesses. Variables starting with _ and containing no uppercase characters (e.g. _secret) are now treated as private — available for config-time interpolation but excluded from the task subprocess environment. This is unlikely to affect existing configurations, but any task that relies on a subprocess reading a _lowercase env var will need to rename it.

• Private arg option names strip leading underscores. An arg named _flag with no explicit options now generates --flag instead of --_flag. A new validation rejects duplicate CLI options across args.

See the migration guide for details and recommended fixes.

New Contributors

• @​brolewis made their first contribution in #​354

Full Changelog: nat-n/poethepoet@v0.42.1...v0.43.0

v0.42.1: 0.42.1

Compare Source

Enhancements

• Add exact option for uv executor by @​charlesbmi in #​365

Completion script fixes

• Isolate zsh completion task options from global options by @​nat-n in #​364
• Fix completion script edge case handling by @​nat-n in #​366

[!IMPORTANT]
You must follow the instructions to (re)install the completion script for your preferred shell environment to benefit from the completion script fixes

New Contributors

• @​charlesbmi made their first contribution in #​365

Full Changelog: nat-n/poethepoet@v0.42.0...v0.42.1

v0.42.0: 0.42.0

Compare Source

Enhancements

• Better zsh completion caaching with max hits per cache and proper TTL before refresh by @​nat-n in #​360
• Officially Support Python 3.14 by @​gruebel in #​362
• Add completion script for PowerShell by @​NSPC911 in #​358

[!IMPORTANT]
You must follow the instructions to (re)install the completion script for your preferred shell environment to benefit from the enhancements for zsh or PowerShell

New Contributors

• @​gruebel made their first contribution in #​362
• @​NSPC911 made their first contribution in #​358

Full Changelog: nat-n/poethepoet@v0.41.0...v0.42.0