-
Notifications
You must be signed in to change notification settings - Fork 114
Open
Labels
Description
What problem does your feature solve?
The stellar --help output currently lists 17 commands in no particular order:
Commands:
contract Tools for smart contract developers
doctor Diagnose and troubleshoot CLI and network issues
events Watch the network for contract events
env Prints the environment variables
keys Create and manage identities including keys and addresses
network Configure connection to networks
container Start local networks in containers
config Manage cli configuration
snapshot Download a snapshot of a ledger from an archive
tx Sign, Simulate, and Send transactions
xdr Decode and encode XDR
completion Print shell completion code for the specified shell
cache Cache for transactions and contract specs
version Print version information
plugin The subcommand for CLI plugins
ledger Fetch ledger information
fee-stats Fetch network feestats
As the CLI grows, discoverability becomes harder. Users need to scan all commands to find what they're looking for, with no logical organization to guide them.
What would you like to see?
Group related commands together with section headers. For example:
Smart Contracts
contract- Tools for smart contract developers
Transactions, Events & Data
tx- Sign, Simulate, and Send transactionsevents- Watch the network for contract eventsledger- Fetch ledger informationsnapshot- Download a snapshot of a ledger from an archive
Identity & Keys
keys- Create and manage identities including keys and addresses
Local Development
container- Start local networks in containers
Network
network- Configure connection to networksfee-stats- Fetch network feestats
Encoding & Formats
xdr- Decode and encode XDR
Configuration & Setup
config- Manage cli configurationnetwork- Configure connection to networksenv- Prints the environment variablescache- Cache for transactions and contract specs
Troubleshooting & Info
doctor- Diagnose and troubleshoot CLI and network issuescompletion- Print shell completion code for the specified shellplugin- The subcommand for CLI pluginsversion- Print version information
What alternatives are there?
- Reorder without headers - Place related commands adjacent to each other without explicit grouping
- Alphabetical ordering - Order commands alphabetically for predictable lookup
- Status quo - Keep current ordering, rely on users to find commands
tupui
Metadata
Metadata
Assignees
Labels
Type
Projects
Status
Backlog (Not Ready)