GitHub
04/10/2026, 8:30 PMmeltano run --help by grouping CLI options into logical categories instead of displaying them in a single flat list.
The options are now organized into:
• Run options – options that affect execution behavior (e.g., --dry-run, --timeout)
• State options – options related to state handling (e.g., --state-strategy, --no-state-update)
• Installation options – plugin installation controls (e.g., --install, --no-install)
• Global options – remaining general-purpose options (e.g., --database-uri, --help)
Key Changes
• Overrode format_options in PartialInstrumentedCmd to support grouped help output
• Categorized options based on their functional responsibility
• Moved:
• --state-strategy under State options
• --timeout under Run options
No changes were made to CLI behavior — this only affects help text rendering.
---
Checklist
• I have read the contribution guide
Was generative AI tooling used to co-author this PR?
• Yes Generated by ChatGPT following the agentic coding guidelines
Related Issues
• Closes #8750
Summary by Sourcery
Group meltano run CLI help options into logical sections without changing command behavior.
Enhancements:
• Introduce grouped help output for the run command, organizing options into Run, State, Installation, and Global categories for improved readability.
Tests:
• Add CLI tests to verify grouped help headings, option placement within each group, group ordering, absence of empty/extra groups, and allowed options within the Global group.
meltano/meltanoGitHub
04/24/2026, 4:29 PM