Skip to content

feat(cli): add colorful styled help output with categorized options#275

Merged
echobt merged 1 commit intomasterfrom
feat/styled-help-output
Jan 27, 2026
Merged

feat(cli): add colorful styled help output with categorized options#275
echobt merged 1 commit intomasterfrom
feat/styled-help-output

Conversation

@echobt
Copy link
Contributor

@echobt echobt commented Jan 27, 2026

Summary

This PR enhances the CLI --help output with a more beautiful and better formatted display:

Changes

  • Colorful styling: Headers (cyan), commands/flags (green), placeholders (yellow), errors (red)
  • ASCII art banner: Beautiful CORTEX banner displayed before help content
  • Categorized options: Options are now grouped into logical categories:
    • Model Configuration (--model, --oss, --profile)
    • Security (--sandbox, --ask-for-approval, --full-auto)
    • Workspace (--cd, --add-dir, --image)
    • Features (--search)
    • Debugging (--log-level)
  • Enhanced after-help section: Environment variables, paths, and examples are now color-coded for better readability
  • Subcommand ordering: Commands are logically ordered by their purpose

New dependency

  • color-print = "0.3" for compile-time colored string generation

Screenshot

The help output now displays with:

  • Bold cyan headers (COMMANDS, OPTIONS, etc.)
  • Green command names and flags
  • Yellow placeholders for values
  • Colored environment variables and examples

- Add clap styling with cyan headers, green commands, yellow placeholders
- Add ASCII art banner to help output
- Categorize options into Model Configuration, Security, Workspace, Features, Debugging
- Add colored environment variables and examples in after-help section
- Organize subcommands by display_order for logical grouping
- Add color-print dependency for styled after-help content
@echobt echobt merged commit 3be8563 into master Jan 27, 2026
2 of 3 checks passed
@echobt echobt deleted the feat/styled-help-output branch January 27, 2026 14:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants