CLI para PMs

# Cheatsheet de Comandos para PMs

> **Qué es:** Referencia rápida de los comandos de terminal más útiles para un PM: navegación, búsqueda, git, APIs con cURL+jq, Docker y Python.
> **Cuándo usarlo:** Tenlo abierto (o impreso) mientras trabajas en terminal; está pensado para consultar, no para memorizar.
> **Requisitos:** Terminal Bash o Zsh (Linux, Mac o WSL en Windows). Algunas secciones requieren git, jq, gh CLI o Docker instalados.

## Navegación y archivos

```bash
pwd                              # Directorio actual
ls -la                           # Listar archivos (incluye ocultos)
cd ~/proyecto                    # Ir a directorio
mkdir -p epica/feature/task      # Crear estructura anidada
cp archivo.txt backup/           # Copiar archivo
mv archivo.txt nuevo-nombre.txt  # Renombrar/mover
rm -rf cache/                    # Eliminar recursivo (¡cuidado!)
```

## Visualización de archivos

```bash
cat spec.md                      # Ver contenido completo
head -n 20 backlog.csv           # Primeras 20 líneas
tail -n 10 logs.txt              # Últimas 10 líneas
tail -f app.log                  # Seguir logs en tiempo real
less archivo-largo.md            # Navegar con flechas (q para salir)
wc -l tareas.csv                 # Contar líneas (= tickets)
```

## Búsqueda y filtrado

```bash
grep "error" logs.txt            # Buscar texto en archivo
grep -r "TODO" src/              # Buscar recursivo en directorio
grep -i "urgente" *.md           # Búsqueda case-insensitive
find . -name "*.spec.md"         # Buscar archivos por nombre
find . -size +1M                 # Archivos mayores a 1MB
sort backlog.csv | uniq -c       # Contar ocurrencias únicas
```

## Git (flujo diario PM)

```bash
git status                       # Ver cambios pendientes
git diff                         # Ver diferencias sin commitear
git add .                        # Preparar todo
git commit -m "feat: agrega login biométrico"  # Commitea con mensaje convencional
git push origin main             # Subir cambios
git pull --rebase                # Traer cambios remotos
git log --oneline -10            # Últimos 10 commits
git branch -a                    # Listar todas las ramas
git checkout -b feature/nueva    # Crear y saltar a nueva rama
git merge feature/nueva          # Fusionar rama
```

## APIs y Web (cURL + jq)

```bash
curl -s https://api.github.com/repos/usuario/repo | jq '.stargazers_count'
curl -s https://api.github.com/repos/usuario/repo/issues | jq 'length'
curl -s -X POST https://api.example.com/data \
  -H "Content-Type: application/json" \
  -d '{"nombre": "proyecto"}' | jq '.id'
curl -s -H "Authorization: Bearer $TOKEN" https://api.example.com/protected | jq .
```

## Docker (n8n, infra local)

```bash
docker ps                        # Contenedores activos
docker ps -a                     # Todos los contenedores
docker compose up -d             # Levantar servicios en background
docker compose logs -f           # Ver logs en vivo
docker compose restart           # Reiniciar servicios
docker compose down              # Detener y limpiar
docker system df                 # Espacio usado por Docker
```

## Python (entornos y dependencias)

```bash
python -m venv .venv             # Crear entorno virtual
source .venv/bin/activate        # Activar (Linux/Mac)
.venv\Scripts\activate           # Activar (Windows)
pip install httpx beautifulsoup4 pandas  # Instalar librerías
pip freeze > requirements.txt    # Exportar dependencias
pip install -r requirements.txt  # Instalar desde archivo
python script.py                 # Ejecutar script
```

## GitHub CLI (gh)

```bash
gh repo create mi-proyecto --public   # Crear repo desde terminal
gh pr create --title "Feature" --body "Descripción" --assignee @me
gh pr review --approve                # Aprobar PR
gh pr list --state open               # PRs abiertos
gh issue list --label "bug"           # Issues por etiqueta
gh run list --limit 5                 # Últimos workflows
```

## SSH y remoto

```bash
ssh usuario@192.168.1.100                        # Conectar a servidor
scp archivo.txt usuario@IP:/ruta/destino         # Copiar archivo
scp -r ./backups/ usuario@IP:/ruta/              # Copiar directorio
ssh -i ~/.ssh/id_rsa -L 8080:localhost:5678 user@host  # Túnel SSH
```

## Procesos y sistema

```bash
ps aux | grep python             # Procesos activos con filtro
kill -9 PID                      # Matar proceso por ID
top -o %MEM                      # Procesos por uso de memoria
df -h                            # Espacio en disco
du -sh directorio/               # Tamaño de directorio
crontab -e                       # Editar tareas programadas
```

## Red

```bash
ping -c 4 google.com             # Verificar conectividad
curl -I https://ejemplo.com      # Ver headers HTTP (sin body)
curl -w "%{http_code}" -s -o /dev/null https://ejemplo.com  # Solo código HTTP
nslookup ejemplo.com             # Resolver DNS
netstat -tulpn                   # Puertos en escucha
```

## Productividad PM

```bash
echo "mejora rendimiento Q3" >> roadmap.md     # Append línea a archivo
alias gh-repo='gh repo view --web'              # Alias temporal
date +%Y-%m-%d                                  # Fecha ISO para logs
watch -n 300 curl -s https://status.example.com  # Monitoreo cada 5 min
```

# ============================================================
# aliases-pm.sh — Aliases y funciones Bash para PMs
# ============================================================
# Qué es:      Colección de atajos de terminal para el trabajo
#              diario de un PM: git, GitHub CLI, APIs y JSON.
# Cuándo usarlo: Cárgalo en tu shell para no memorizar comandos
#              largos. Funciona en Bash y Zsh (Linux/Mac/WSL).
# Requisitos:  git, curl, jq y gh CLI instalados.
#              (jq: https://jqlang.github.io/jq/ — gh: https://cli.github.com/)
# Cómo usarlo: 1. Guarda este archivo en tu home: ~/aliases-pm.sh
#              2. Agrégalo a tu shell:
#                   echo 'source ~/aliases-pm.sh' >> ~/.bashrc   # o ~/.zshrc
#              3. Recarga: source ~/.bashrc
# ============================================================

# ---------- Git: leer el repo sin abrir el navegador ----------
alias gl='git log --oneline --graph --decorate -15'      # Historia compacta
alias gs='git status -sb'                                 # Estado corto
alias gd='git diff --stat'                                 # Qué archivos cambiaron
alias gquien='git shortlog -sn --since="1 month ago"'      # Quién comiteó este mes

# Ver qué cambió en un archivo y quién lo tocó
# Uso: gblame src/app/page.tsx
gblame() {
  git log --oneline -5 -- "$1" && echo "---" && git blame --date=short "$1" | head -20
}

# ---------- GitHub CLI: PRs e issues desde terminal ----------
alias prs='gh pr list --limit 15'                          # PRs abiertos
alias prsmios='gh pr list --author "@me"'                  # Mis PRs
alias issues='gh issue list --limit 15'                    # Issues abiertos

# Resumen de un PR: estado, checks y archivos
# Uso: prinfo 123
prinfo() {
  gh pr view "$1" && echo "--- CHECKS ---" && gh pr checks "$1"
}

# ---------- APIs: consultar sin Postman ----------
# GET a cualquier API con JSON formateado
# Uso: api https://api.github.com/repos/github/spec-kit
api() {
  curl -s "$1" | jq '.'
}

# Métricas rápidas de un repo de GitHub
# Uso: gh-metrics github/spec-kit
gh-metrics() {
  curl -s "https://api.github.com/repos/$1" | jq '{estrellas: .stargazers_count, forks: .forks_count, issues_abiertos: .open_issues_count, ultimo_push: .pushed_at}'
}

# Estado de una API (código HTTP y tiempo de respuesta)
# Uso: apistatus https://api.miempresa.com/health
apistatus() {
  curl -s -o /dev/null -w "HTTP %{http_code} — %{time_total}s\n" "$1"
}

# ---------- Productividad ----------
alias hoy='date +%Y-%m-%d'                                 # Fecha ISO para nombres de archivo
alias puerto='lsof -i'                                     # Qué está usando cada puerto
alias myip='curl -s ifconfig.me && echo'                   # IP pública

# Crear carpeta de proyecto con la convención del equipo
# Uso: nuevoproyecto mi-feature
nuevoproyecto() {
  mkdir -p "$1"/{specs,docs,data} && cd "$1" && git init -q && echo "✅ $1 creado con specs/, docs/, data/"
}