Home es

LockedIn CLI — un tutorial con temática de sátira para construir con un agente de IA

🌎 Idioma: Español — ver los 33 idiomas

Bienvenido/a. Esta wiki es un tutorial práctico y apto para principiantes para construir una herramienta de línea de comandos real con un asistente de código de IA agéntico — usando un ejemplo muy tonto para que aprender sea divertido.

El ejemplo es LockedIn CLI: una “CLI de IA” de mentira que parodia las herramientas de desarrollo de la era de la IA y el “liderazgo de pensamiento” de las redes profesionales. Tiene un splash con degradado, una sesión de chat interactiva, slash commands y un modelo que “piensa” muy fuerte — y produce cero valor profesional, a propósito. Bajo los chistes, sin embargo, es un proyecto Node.js limpio y bien probado, ideal para aprender.

El chiste es una herramienta de enseñanza. Te reirás de bandejas de entrada llenas de spam de reclutadores mientras aprendes discretamente arquitectura, testing y — lo más importante — cómo dirigir a un agente de IA para que escriba y modifique código real por ti.

---

¿Para quién es esto?

• Nuevo/a en la programación agéntica / asistida por IA. Quizás usaste un asistente de chat, pero aún no has dirigido un agente que edita archivos, ejecuta pruebas y publica cambios. Iremos despacio con esa parte.
• Cómodo/a con los fundamentos de programación. Sabes leer JavaScript, usar una terminal y seguir una función. El código aquí es intermedio; la parte de IA es de principiante. (No necesitas experiencia previa con frameworks: esto es Node puro y sin dependencias.)

Cualquier agente de código capaz sirve. Los ejemplos usan GitHub Copilot CLI (el mismo agente que escribió este proyecto), pero el flujo se transfiere a otros agentes también.

La única regla: la barrera de pruebas 🧪

Este proyecto tiene una regla estricta, y todo el tutorial gira en torno a ella:

Nada se publica a menos que npm test pase.

Un agente de IA puede escribir muchísimo código muy rápido. La suite de validación es cómo mantienes el control. Aprenderás a hacer que el agente trabaje detrás de esa barrera: describe el cambio, deja que agregue pruebas, deja que implemente, y solo acepta el trabajo cuando la suite esté en verde.

Cómo usar este tutorial

Recorre los capítulos en orden. Cada uno es corto, termina con un ejercicio “Pruébalo con tu agente” y se apoya en el anterior.

1. 1 Orientación — configura el proyecto, ejecútalo, conoce a tu agente y corre la barrera de pruebas por primera vez.
2. 2 Cómo funciona el código — la arquitectura que hace que este proyecto sea fácil (y seguro) de cambiar para un agente: un núcleo puro y testeable; aleatoriedad con semilla; y la suite de pruebas.
3. 3 Tu primera tarea con el agente — el evento principal: agrega un comando nuevo de principio a fin dirigiendo al agente, con las pruebas primero.
4. 4 Prompting y revisión — haz prompts como líder, revisa los diffs del agente, itera y mantén el impulso entre sesiones.
5. 5 Localización — cómo la CLI habla 33 idiomas, y cómo dirigir a un agente para añadir otro más (i18n, paridad de claves, doble ancho y marcas combinantes).

¿Quieres los documentos “en el universo” del chiste? Están en Referencia de comandos (el “manual” satírico original). ¿Usas tecnología de asistencia? Consulta Accesibilidad — la CLI tiene modos de lector de pantalla, alto contraste y baja distracción.

Contribuir con un agente de código

Las contribuciones son bienvenidas. Clona el repositorio y abre tu copia local con cualquier agente de código capaz, como Claude Code, Cursor o Codex. Indícale que siga las instrucciones del repositorio y estos tutoriales, revisa sus cambios y ejecuta npm test antes de enviar tu contribución. Son solo ejemplos, no recomendaciones ni integraciones incluidas.

---

Requisitos de un vistazo

• Node.js 18+ (Linux, macOS o Windows — es idéntico en los tres).
• git y un asistente de código con capacidad de agente (p. ej., GitHub Copilot CLI).
• ~30–60 minutos y sentido del humor.

¿List@? Ve a 1 Orientación.

---

_{Sátira. LockedIn CLI es una parodia de las herramientas de línea de comandos de la era de la IA y de la cultura del “liderazgo de pensamiento” — no está afiliado con, ni respaldado ni representado por LinkedIn, ni ninguna empresa real. Escrito por un modelo de lenguaje grande (GitHub Copilot CLI, Claude Opus 4.8) bajo la dirección de un humano, y con licencia GPL-3.0-or-later. Ejecuta lockedin legal para el aviso completo.}