CLI ergonomics

The design discipline of making command-line tools legible and pleasant for both humans and agents through careful flags, output shape, and sensible defaults.

grounded in: latest AI/tech trend: 'CLI craft revival — command-line design and Rust systems ergonomics' theme (HN front page, 2026-07-16); this system is driven by shell CLIs (run-agent.sh, rc-session.sh, spark.s