Guía de diseño de interfaces de línea de comandos: principios y buenas prácticas

Fuentes: Command Line Interface Guidelines: principles and practices for modern CLIs

Command Line Interface Guidelines es una guía de código abierto, alojada en GitHub, que reúne principios de diseño y recomendaciones prácticas para crear programas de línea de comandos (CLI) modernos. Su propósito es actualizar la filosofía UNIX clásica, pensada para máquinas, a un contexto actual donde la CLI es ante todo una interfaz para personas.

La obra se estructura en dos grandes bloques: una parte filosófica, donde se exponen ideas como el diseño orientado a humanos, la composabilidad de programas pequeños que cooperan entre sí y la consistencia entre herramientas; y otra parte más normativa, con pautas concretas sobre sintaxis, opciones, mensajes de error, ayuda, formato de salida y otros aspectos de la experiencia de uso.

¿A quién va dirigida? Principalmente a desarrolladoras y desarrolladores que crean herramientas CLI y buscan criterios de diseño de interfaz, y a quienes quieren evitar errores comunes que rompen convenciones acumuladas durante cuarenta años. También resulta útil para profesionales dedicados al diseño de interfaces CLI y para quienes deseen aprender de la experiencia de autoras y autores con años de práctica.

La guía se desmarca explícitamente de los programas de pantalla completa tipo Emacs o Vim, y es agnóstica respecto al lenguaje de programación empleado. Subraya que la línea de comandos sigue siendo un espacio versátil, disponible en casi cualquier portátil, automatizable y estable, por lo que conviene maximizar su utilidad mientras siga presente. El texto combina principios, ejemplos y normas específicas para que cualquier proyecto CLI sea intuitivo, predecible y agradable de usar.