frames-engineering/websh

¿Qué hace websh?

Un shell para la web. Navega por URLs como directorios, consulta páginas con comandos tipo Unix. Se activa con el comando websh, navegación web estilo shell, o al tratar URLs como un sistema de archivos.

Introducción

websh transforma la web en un sistema de archivos navegable. Cada URL es un "directorio" que contiene archivos como el HTML, los recursos vinculados (CSS, JS, imágenes), y los metadatos de la página. Los comandos familiares de Unix (ls, cd, cat, grep) se adaptan para trabajar con contenido web.

Comandos principales

• ls [url]: Lista el contenido de una URL (por ejemplo, enlaces, imágenes, scripts).
• cd [url]: Navega a un nuevo directorio URL.
• cat [url]: Muestra el contenido textual de una página (similar a cat en archivos).
• grep <patrón> [url]: Busca un patrón en el contenido de una página.
• pwd: Muestra la URL actual.
• tree [url]: Muestra un árbol de recursos vinculados desde una URL.

Ejemplos

# Navegar a un sitio
cd https://ejemplo.com

# Listar contenido
ls

# Ver el contenido de una página
cat https://ejemplo.com/pagina

# Buscar un término
grep "tecnología" https://ejemplo.com

Plataformas compatibles

• Claude Code: Activa websh mediante el comando directo o al detectar URLs como rutas.
• Cursor: Integración similar con navegación web.
• Codex: Compatible con entornos de terminal que soporten comandos tipo Unix.

Notas técnicas

• websh utiliza solicitudes HTTP internas para obtener el contenido de las páginas.
• El análisis de HTML se realiza con un parser robusto para extraer enlaces, texto y metadatos.
• Los comandos pueden combinarse con tuberías (por ejemplo, cat url | grep patrón).

Licencia

MIT