Comandos de Serpl

Comandos completos de la interfaz de usuario de terminal Serpl para operaciones de búsqueda y reemplazo en todo el proyecto.

Instalación

Comando	Descripción
cargo install serpl	Instalar vía Cargo (Rust)
brew install serpl	Instalar vía Homebrew (macOS)
nix-env -i serpl	Instalar vía Nix
pacman -S serpl	Instalar en Arch Linux
Download from GitHub Releases	Binarios precompilados disponibles
serpl --version	Mostrar versión de Serpl

Uso Básico

Comando	Descripción
serpl	Lanzar Serpl en directorio actual
serpl --search-text "oldFunc"	Lanzar con término de búsqueda pre-relleno
serpl --replace-text "newFunc"	Lanzar con reemplazo pre-relleno
serpl --search-path ./src	Buscar en directorio específico
serpl --hidden	Incluir archivos ocultos en búsqueda
serpl --ignore-case	Búsqueda insensible a mayúsculas/minúsculas

Teclas de Navegación

Atajo	Descripción
j	Mover hacia abajo en lista de resultados
k	Mover hacia arriba en lista de resultados
g	Saltar al primer resultado
G	Saltar al último resultado
/	Buscar dentro de la lista de resultados
Enter	Seleccionar/confirmar acción
Escape	Cancelar/volver atrás
q	Salir de Serpl

Cambio de Modo

Atajo	Descripción
Tab	Cambiar entre campos de búsqueda y reemplazo
Ctrl + N	Alternar entre modos de búsqueda y reemplazo
Ctrl + B	Abrir diálogo de ayuda
Ctrl + C	Salir de la aplicación

Operaciones de Búsqueda

Atajo	Descripción
Type in search field	Búsqueda en vivo en todos los archivos
Ctrl + N	Alternar modo de búsqueda
Case-sensitive mode	Coincidir con mayúsculas exactas
Case-insensitive mode	Ignorar diferencias de mayúsculas
Regex mode	Usar expresiones regulares
AST Grep mode	Búsqueda de código estructurado

Operaciones de Reemplazo

Atajo	Descripción
Ctrl + O	Procesar reemplazo para TODOS los archivos
d	Eliminar archivo seleccionado o línea de resultados
Simple replace	Reemplazar directamente todas las ocurrencias
Preserve case replace	Mantener patrón de mayúsculas original
AST Grep replace	Reemplazo consciente del árbol de sintaxis

Modos de Reemplazo

Modo	Descripción
Simple	Reemplazo de texto directo
Preserve Case	Coincide con el patrón de mayúsculas del texto original
AST Grep	Reemplazo de patrones consciente del árbol de sintaxis

Modos de Búsqueda

Modo	Descripción
Fixed String	Coincidencia de texto literal
Regex	Coincidencia de expresión regular
AST Grep	Coincidencia de patrones de código estructurado

Operaciones de Archivo

Atajo	Descripción
d	Eliminar archivo/línea de resultados (omitir)
Ctrl + O	Aplicar reemplazos a todos los archivos restantes
Review changes per file	Ver vista previa antes de aplicar
Undo is not available	Los cambios son permanentes—use Git

Configuración

Configuración	Descripción
~/.config/serpl/config.json	Ubicación del archivo de configuración
Custom key bindings	Anular atajos predeterminados
Search mode default	Establecer modo de búsqueda preferido
Replace mode default	Establecer modo de reemplazo preferido
File pattern filters	Configurar qué archivos incluir
Ignore patterns	Configurar qué archivos excluir

Configuración de Ejemplo

{
  "key_bindings": {
    "quit": "q",
    "navigate_up": "k",
    "navigate_down": "j",
    "go_to_top": "g",
    "go_to_bottom": "G",
    "delete": "d",
    "process_replace": "Ctrl+o",
    "toggle_help": "Ctrl+b",
    "search_in_list": "/"
  },
  "search_mode": "fixed_string",
  "replace_mode": "simple"
}

Flujos de Trabajo Comunes

Flujo de Trabajo	Descripción
Rename variable	Buscar nombre antiguo → Reemplazar con nuevo nombre
Update import paths	Buscar ruta antigua → Reemplazar con nueva ruta
Migrate API calls	Buscar deprecado → Reemplazar con nueva API
Fix typos across project	Buscar error ortográfico → Reemplazar con corrección
Update config values	Buscar valor antiguo → Reemplazar con valor nuevo

Integración con Git

Flujo de Trabajo	Descripción
git diff after serpl	Revisar todos los cambios realizados
git stash before serpl	Guardar trabajo actual primero
git checkout -- . to undo	Revertir todos los cambios si es necesario
Work in a branch	Aislar cambios de búsqueda-reemplazo
git add -p after serpl	Preparar cambios selectivamente

Comparación con Alternativas

Característica	Serpl	sed	VS Code
Interactive preview	Sí	No	Sí
TUI interface	Sí	No	GUI
Preserve case	Sí	Manual	Sí
AST Grep	Sí	No	Extensión
Works over SSH	Sí	Sí	No
Regex support	Sí	Sí	Sí

Consejos y Mejores Prácticas

Consejo	Descripción
Always use Git	Hacer commit antes de ejecutar reemplazos
Preview before applying	Revisar cada cambio en el TUI
Use AST Grep for code	La coincidencia estructurada evita falsos positivos
Use preserve case	Mantiene camelCase, PascalCase, etc.
Remove false positives	Usar d para omitir coincidencias no deseadas
Search specific paths	Usar --search-path para estrechar el alcance
Check hidden files	Usar bandera --hidden cuando sea necesario