Repolode
thomasschafer

thomasschafer/scooter

Una interfaz de terminal para buscar y reemplazar de forma interactiva en archivos o en stdin, con búsquedas por regex o cadenas literales y revisión de cada coincidencia.

Estrellas
1,302
Forks
19
Issues abiertos
12
Último commit
hace 4 días

¿Qué es?

scooter es una herramienta de búsqueda y reemplazo que se ejecuta en la terminal. De forma predeterminada, busca recursivamente en los archivos del directorio actual, y también puede procesar texto enviado por stdin. Indicas una cadena de búsqueda y otra de reemplazo, y luego activas o desactivas las coincidencias que quieres reemplazar antes de aplicar los cambios.

Las búsquedas pueden usar una cadena literal o una expresión regular, con grupos de captura opcionales en el reemplazo, como $1 y $2. Entre las opciones están la búsqueda de palabras completas y con distinción entre mayúsculas y minúsculas, el modo multilínea, filtros de inclusión y exclusión de archivos basados en glob, y la compatibilidad con los archivos .gitignore y .ignore. Se omiten las coincidencias que hayan cambiado desde que se ejecutó la búsqueda y se informa de ellas al final, para evitar sobrescribir resultados obsoletos.

El recorrido de archivos está basado en ripgrep. También incluye temas de resaltado de sintaxis, integración con el editor para abrir los resultados en $EDITOR en la línea correspondiente y un modo sin TUI para usarlo en scripts.

Funciones clave

  • 01Revisión interactiva: activa o desactiva cada coincidencia antes de reemplazarla.
  • 02Admite búsquedas por cadenas literales y regex, con grupos de captura en los reemplazos.
  • 03Filtra archivos con patrones glob de inclusión y exclusión.
  • 04Respeta los archivos .gitignore y .ignore y, de forma predeterminada, omite los archivos ocultos.
  • 05Puede procesar stdin canalizado y mostrar resultados sin la TUI.

Casos de uso

  • Cambiar el nombre de un identificador en todo el código y revisar cada cambio.
  • Hacer modificaciones masivas de texto en el directorio de un proyecto desde la terminal.
  • Transformar texto canalizado en scripts de shell con el modo --no-tui.

Inicio rápido

  1. 1

    Instala scooter con Homebrew (macOS y Linux)

    brew install scooter
  2. 2

    Inicia scooter en una terminal desde el directorio que quieras buscar

    scooter

Antes de usarlo

  • De forma predeterminada, el motor de expresiones regulares solo admite un subconjunto de funciones, por lo que los patrones avanzados, como la anticipación, necesitan la opción -a.
  • Se omiten las sustituciones si una línea coincidente ha cambiado después de la búsqueda; estos casos omitidos solo se enumeran al final.

En colecciones

Temas

Preguntas frecuentes

¿Qué es scooter?
Una interfaz de terminal para buscar y reemplazar de forma interactiva en archivos o en stdin, con búsquedas por regex o cadenas literales y revisión de cada coincidencia. scooter es una herramienta de búsqueda y reemplazo que se ejecuta en la terminal. De forma predeterminada, busca recursivamente en los archivos del directorio actual, y también puede procesar texto enviado por stdin. Indicas una cadena de búsqueda y otra de reemplazo, y luego activas o desactivas las coincidencias que quieres reemplazar antes de aplicar los cambios.
¿scooter es gratuito? ¿Qué licencia tiene?
scooter es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿scooter sigue mantenido?
Mantenimiento activo. El último commit de scooter fue el 18 oct 2026.
¿Para qué puedo usar scooter?
Cambiar el nombre de un identificador en todo el código y revisar cada cambio. Hacer modificaciones masivas de texto en el directorio de un proyecto desde la terminal. Transformar texto canalizado en scripts de shell con el modo --no-tui.
¿Cómo se instala scooter?
Instala scooter con Homebrew (macOS y Linux): brew install scooter Inicia scooter en una terminal desde el directorio que quieras buscar: scooter
¿Dónde consigo scooter?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/thomasschafer/scooter

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados