# What changed in sphinx-argparse-cli

> 9 changes in sphinx-argparse-cli 1 from its official release notes, upgrade guides and advisories: 2 breaking, 2 new APIs and options. Each one cited. Sources checked 2026-10-19. HTML: https://unstale.sh/pypi/sphinx-argparse-cli/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## sphinx-argparse-cli 1

### Breaking changes

- Python 3.11 is now required to use sphinx-argparse-cli. (1.24.0) — [release notes](https://github.com/tox-dev/sphinx-argparse-cli/releases/tag/1.24.0)
- Python 3.15 is now used by default. (1.24.0) — [release notes](https://github.com/tox-dev/sphinx-argparse-cli/releases/tag/1.24.0)

### New APIs and options

- The {subcommand} placeholder expands to the subcommand name chain. (1.23.0) — [release notes](https://github.com/tox-dev/sphinx-argparse-cli/releases/tag/1.23.0)
- Flags and positional arguments are registered as Sphinx program options, allowing the :option: role to link to them. (1.23.0) — [release notes](https://github.com/tox-dev/sphinx-argparse-cli/releases/tag/1.23.0)

### Behavior and default changes

- :hook: now intercepts parse_intermixed_args(). (1.23.0) — [release notes](https://github.com/tox-dev/sphinx-argparse-cli/releases/tag/1.23.0)
- ANSI colors are stripped from usage blocks, and subcommands with suppressed help are skipped. (1.23.0) — [release notes](https://github.com/tox-dev/sphinx-argparse-cli/releases/tag/1.23.0)

### Fixes and other changes

- Untitled argument groups, multi-paragraph help, positional arguments, subcommand epilogs, formatter line breaks, metavars, choices, and argparse format specifiers are rendered correctly. (1.23.0) — [release notes](https://github.com/tox-dev/sphinx-argparse-cli/releases/tag/1.23.0)
- Apostrophes are preserved in help text. (1.23.0) — [release notes](https://github.com/tox-dev/sphinx-argparse-cli/releases/tag/1.23.0)
- Type checks for nested subparsers are fixed. (1.22.1) — [release notes](https://github.com/tox-dev/sphinx-argparse-cli/releases/tag/1.22.1)