@icarusmx/creta 1.5.13 → 1.5.14

package/bin/creta.js

@@ -681,6 +681,7 @@ function showHelp() {
   console.log("📖 Documentación de comandos:")
   console.log("  creta ls             - Documentación en español del comando ls")
   console.log("  creta grep           - Documentación en español del comando grep")
+  console.log("  creta lz             - Localiza recursos (alias de curl)")
   console.log("  creta cd             - Documentación en español del comando cd")
   console.log("  creta curl           - Documentación en español del comando curl")
   console.log("  creta git status     - Documentación en español de git status")
@@ -1904,7 +1905,7 @@ async function startVimSetupTutorial() {
 // Helper function to detect command help requests
 function isCommandHelpRequest(args) {
   // List of supported commands for help
-  const basicCommands = ['ls', 'cd', 'mkdir', 'touch', 'wc', 'curl', 'grep']
+  const basicCommands = ['ls', 'cd', 'mkdir', 'touch', 'wc', 'curl', 'grep', 'lz']
   const gitCommands = ['git status', 'git add', 'git commit', 'git push', 'git log']
 
   const commandString = args.join(' ')

package/lib/data/command-help/grep.js

@@ -23,6 +23,10 @@ export const grep = {
       flag: '-c',
       description: 'Cuenta líneas que coinciden'
     },
+    {
+      flag: '-q',
+      description: 'Modo silencioso (no imprime nada, solo devuelve código de salida)'
+    },
     {
       flag: '-l',
       description: 'Solo muestra nombres de archivos con coincidencias'

package/lib/data/command-help/index.js

@@ -6,6 +6,7 @@ export { touch } from './touch.js'
 export { wc } from './wc.js'
 export { curl } from './curl.js'
 export { grep } from './grep.js'
+export { lz } from './lz.js'
 
 // Git commands
 export { gitStatus } from './git-status.js'
@@ -27,6 +28,7 @@ export const commandMap = {
   'wc': 'wc',
   'curl': 'curl',
   'grep': 'grep',
+  'lz': 'lz',
 
   // Git
   'git status': 'gitStatus',

package/lib/data/command-help/lz.js

@@ -0,0 +1,57 @@
+export const lz = {
+  command: 'lz',
+  description: 'Localiza un recurso en la web (alias didáctico de curl)',
+  usage: 'lz [url]',
+  commonOptions: [
+    {
+      flag: '-O',
+      description: 'Guarda el archivo con su nombre original'
+    },
+    {
+      flag: '-o archivo',
+      description: 'Guarda el contenido en el archivo especificado'
+    },
+    {
+      flag: '-L',
+      description: 'Sigue redirecciones automáticamente'
+    },
+    {
+      flag: '-I',
+      description: 'Solo muestra los headers (encabezados)'
+    },
+    {
+      flag: '-s',
+      description: 'Modo silencioso (no muestra progreso)'
+    }
+  ],
+  examples: [
+    {
+      command: 'lz icarus.mx/README.md',
+      description: 'Localiza y muestra el contenido del README'
+    },
+    {
+      command: 'lz -O icarus.mx/logo.png',
+      description: 'Descarga logo.png con su nombre original'
+    },
+    {
+      command: 'lz -o mi-archivo.json api.ejemplo.com/data',
+      description: 'Guarda la respuesta en mi-archivo.json'
+    },
+    {
+      command: 'lz -I icarus.mx',
+      description: 'Muestra solo los headers del sitio'
+    },
+    {
+      command: 'lz -sL api.ejemplo.com | grep "version"',
+      description: 'Busca "version" en la respuesta (silencioso + sigue redirects)'
+    }
+  ],
+  relatedLesson: 'Curl y pipes',
+  tips: [
+    '🧠 lz = "localiza recurso" - Alias en español para curl',
+    'curl significa "Client URL" - Cliente para Localizar Recursos Universales',
+    'Lo "universal" viene del protocolo HTTP (HyperText Transfer Protocol)',
+    'En la terminal real usa curl, pero lz te ayuda a pensar en español',
+    'Pro tip: lz es perfecto para probar APIs rápidamente'
+  ]
+}

package/lib/exercises/13-shell-aliases.md

@@ -0,0 +1,134 @@
+# Shell Aliases: Personaliza tu Terminal
+
+## Objetivo
+
+Aprende a crear alias de shell para hacer comandos más intuitivos y personalizados. Crearemos el alias `lz` (localiza recurso) para `curl`.
+
+## ¿Qué es un Alias?
+
+Un alias es un atajo personalizado para un comando. Por ejemplo:
+- En vez de escribir `curl https://icarus.mx`
+- Escribes `lz https://icarus.mx`
+
+## Por qué `lz` para curl
+
+**curl** = Client URL (Cliente de URL)
+- **Cliente**: localiza recursos para ti
+- **Universal**: usa HTTP (HyperText Transfer Protocol)
+- **lz**: "localiza recurso" - alias en español
+
+## Paso 1: Identificar tu Shell
+
+En macOS Catalina+ se usa `zsh` por defecto:
+
+```bash
+echo $SHELL
+```
+
+Si ves `/bin/zsh` → usas zsh (archivo: `~/.zshrc`)
+Si ves `/bin/bash` → usas bash (archivo: `~/.bashrc`)
+
+## Paso 2: Abrir el Archivo de Configuración
+
+Para zsh (más común en Mac):
+
+```bash
+nvim ~/.zshrc
+```
+
+O si prefieres VS Code:
+
+```bash
+code ~/.zshrc
+```
+
+## Paso 3: Agregar el Alias
+
+Al final del archivo, agrega:
+
+```bash
+# Alias personalizados
+alias lz='curl'
+```
+
+Guarda el archivo:
+- En nvim: presiona `ESC`, luego escribe `:wq` y `ENTER`
+- En VS Code: `Cmd + S`
+
+## Paso 4: Recargar la Configuración
+
+Tienes dos opciones:
+
+**Opción 1: Recargar el archivo**
+```bash
+source ~/.zshrc
+```
+
+**Opción 2: Cerrar y abrir una nueva terminal**
+
+## Paso 5: Probar el Alias
+
+```bash
+lz icarus.mx
+```
+
+Deberías ver el HTML del sitio de Icarus.
+
+## Alias Útiles para Agregar
+
+Mientras estás editando `~/.zshrc`, considera agregar:
+
+```bash
+# Alias para comandos comunes
+alias ls='ls -G'                    # ls con colores en Mac
+alias ll='ls -lah'                  # ls largo con todo
+alias ..='cd ..'                    # sube un nivel
+alias ...='cd ../..'                # sube dos niveles
+alias gs='git status'               # git status rápido
+alias ga='git add'                  # git add rápido
+alias gc='git commit -m'            # git commit con mensaje
+alias gp='git push'                 # git push rápido
+alias lz='curl'                     # localiza recurso (nuestro nuevo alias)
+
+# Alias para navegación rápida
+alias proyectos='cd ~/proyectos'
+alias icarus='cd ~/icarus'
+```
+
+## Verificar que Funciona
+
+```bash
+# Probar lz
+lz -I icarus.mx
+
+# Debería mostrar los headers del sitio
+```
+
+## Troubleshooting
+
+**Problema: "command not found: lz"**
+- Solución: Verifica que ejecutaste `source ~/.zshrc`
+
+**Problema: "No such file or directory: ~/.zshrc"**
+- Solución: Crea el archivo primero: `touch ~/.zshrc`
+
+**Problema: Sigo usando bash en vez de zsh**
+- Solución: Edita `~/.bashrc` en vez de `~/.zshrc`
+
+## Siguiente Nivel
+
+Una vez que domines los alias básicos, aprende sobre:
+- **Funciones de shell**: alias con argumentos complejos
+- **Dotfiles**: versionar tu configuración con Git
+- **Oh My Zsh**: framework para mejorar tu terminal
+
+## Recursos
+
+- `man zsh` - Manual de zsh
+- `man bash` - Manual de bash
+- `alias` - Ver todos tus alias actuales
+- `unalias lz` - Eliminar un alias temporal
+
+---
+
+**Pro tip**: Los alias se cargan cada vez que abres una terminal nueva. Si quieres un alias temporal (solo para la sesión actual), simplemente escribe `alias lz='curl'` directo en la terminal sin agregarlo al archivo.

package/lib/exercises/README.md

@@ -34,6 +34,12 @@ Each phase builds on knowledge from previous phases.
 **Time:** 15 minutes
 **Level:** 🟢 Beginner
 
+### 13. [Shell Aliases: Personaliza tu Terminal](./13-shell-aliases.md)
+**What:** Crear alias personalizados (lz para curl)
+**Why:** Comandos más intuitivos en español - piensa "localiza recurso"
+**Time:** 10 minutes
+**Level:** 🟢 Beginner
+
 ### 4. [Array & Object Manipulation](./04-array-object-manipulation.md)
 **What:** JavaScript warmups - map, filter, reduce, destructuring
 **Why:** Foundation for real app data transformations
@@ -144,6 +150,7 @@ Prefer to browse by subject?
 - [Developing Muscle Memory for Neovim](./01-developing-muscle-for-nvim.md)
 - [iTerm2 Pane Navigation](./02-iterm2-pane-navigation.md)
 - [Git Stash Workflow](./03-git-stash-workflow.md)
+- [Shell Aliases](./13-shell-aliases.md)
 - [curl + Pipes](./06-curl-and-pipes.md)
 
 ### JavaScript & Development

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icarusmx/creta",
-  "version": "1.5.13",
+  "version": "1.5.14",
   "description": "Salgamos de este laberinto.",
   "type": "module",
   "bin": {