Skip to content

fast-folder-cli v1.0.0

Choose a tag to compare

@AnthonyCZ6 AnthonyCZ6 released this 29 Sep 23:59
· 13 commits to main since this release

Primera versión estable de fast-folder-cli: busca cualquier carpeta de Windows en segundos desde la terminal, como reemplazo de la lenta búsqueda del Explorador de archivos.

✨ Características

  • 🚀 Búsqueda concurrente: varias goroutines recorren el disco en paralelo (≈8.7× más rápido que Get-ChildItem -Recurse en un perfil de ~149,000 carpetas).
  • 🔤 Coincidencia flexible: subcadena sin distinguir mayúsculas (-n proy) o comodines *, ?, [ ] (-n "tesis*").
  • 🌐 Variables de entorno: %APPDATA%, %LOCALAPPDATA%, %USERPROFILE%, %PROGRAMDATA%, ~ y D:, también desde PowerShell.
  • 🛡️ Tolerante a errores: las carpetas sin permisos se omiten y se contabilizan sin detener la búsqueda.
  • 🔁 Seguro con enlaces: las uniones (junctions) y enlaces simbólicos no se recorren, evitando ciclos infinitos.
  • 👻 Ocultas y de sistema excluidas por defecto; -a / --all las incluye.
  • 📂 -o / --open abre la primera coincidencia en el Explorador de Windows.
  • 📦 Sin dependencias: un único ejecutable de menos de 2.5 MB.

📥 Instalación

Asistente de instalación: descarga
fast-folder-cli-setup.exe,
ábrelo y sigue los pasos. No requiere permisos de administrador, instala la versión
adecuada para tu equipo (x64 o ARM64), agrega fast-folder-cli al PATH con el atajo
fast y se puede desinstalar desde Configuración → Aplicaciones. Después, abre una
terminal nueva y escribe fast --help.

Desde la terminal: abre PowerShell y ejecuta (instala o actualiza):

irm https://raw.githubusercontent.com/AnthonyCZ6/fast-folder-cli/main/install.ps1 | iex

El script detecta si tu equipo es x64 o ARM64, verifica la suma SHA-256 y agrega
fast-folder-cli al PATH con el atajo fast. Para instalar exactamente esta versión:

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/AnthonyCZ6/fast-folder-cli/main/install.ps1))) -Version v1.0.0

¿Tienes Go 1.23 o superior? go install github.com/AnthonyCZ6/fast-folder-cli@v1.0.0

Descarga manual
Equipo Archivo
Windows x64 (Intel o AMD, la mayoría de los equipos) fast-folder-cli-windows-amd64.exe
Windows ARM64 (Snapdragon, Surface Pro X) fast-folder-cli-windows-arm64.exe

Renómbralo a fast-folder-cli.exe y agrégalo al PATH siguiendo
las instrucciones del README.

🚀 Uso rápido

fast-folder-cli -n proyecto                       # busca en tu perfil de usuario
fast-folder-cli -n discord -p %APPDATA% -a        # en AppData, incluyendo ocultas
fast-folder-cli -n "tesis*" -p D: -o              # en otra unidad y abre el primer resultado

🔒 Verificación

Los ejecutables no están firmados digitalmente, así que Windows SmartScreen puede mostrar "Windows protegió su PC" al abrir el asistente: pulsa Más información → Ejecutar de todas formas. El script de PowerShell comprueba la suma SHA-256 automáticamente; si descargas un archivo a mano, compáralo con checksums.txt:

Get-FileHash .\fast-folder-cli-windows-amd64.exe

Changelog completo: https://github.com/AnthonyCZ6/fast-folder-cli/commits/v1.0.0