ux: standardize --name vs --key-name flag across commands

[owenwahlgren]

Description

Key commands use --name for the key identifier, but the global flag is --key-name. This inconsistency is confusing for users.

Current behavior

• platform keys import --name mykey (local flag)
• platform wallet balance --key-name mykey (global flag)

Two different flag names for the same concept.

Expected behavior

Standardize on --key-name everywhere, or alias --name to --key-name in key commands.

Files affected

• cmd/keys.go (lines 464, 468, 475, 479, 483) - uses --name
• cmd/root.go (line 65) - uses --key-name

Severity

High UX impact - confusing for new users

Source

CLI UX audit (2026-02-09)