frames-engineering/websh

Un shell pour le web. Naviguez dans les URL comme des répertoires, interrogez des pages avec des commandes de type Unix. S'active sur la commande `websh`, la navigation web en mode shell, ou en traitant les URL comme un système de fichiers.

Qu'est-ce que websh ?

`frames-engineering/websh` est une compétence d'agent IA qui transforme le web en un système de fichiers navigable en ligne de commande. Elle permet aux agents (comme Claude Code, Cursor, ou Codex) de traiter les URL comme des chemins de répertoires, d'utiliser des commandes Unix classiques (`ls`, `cd`, `cat`, `grep`) sur des pages web, et d'explorer le web de manière intuitive. Cette compétence est particulièrement utile pour les opérations de scraping structuré, la vérification de documentation, la navigation multi-pages, et l'inspection de sites web sans recourir à des API complexes. Compatible avec les environnements shell standard, elle s'active via la commande `websh` ou en traitant les URL comme des chemins de fichiers. En pratique, un agent peut exécuter `ls https://example.com` pour lister les ressources d'une page, `cd /api/docs` pour naviguer dans une arborescence, ou `grep "error" /var/log` pour rechercher des motifs dans le contenu web. L'approche remplace les requêtes HTTP traditionnelles par une métaphore de système de fichiers, rendant l'interaction web aussi naturelle que la manipulation de dossiers locaux.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/frames-engineering/skills/tree/main/skills/websh

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait websh ?

Un shell pour le web. Naviguez dans les URL comme des répertoires, interrogez des pages avec des commandes de type Unix. S'active sur la commande websh, la navigation web en mode shell, ou en traitant les URL comme un système de fichiers.

Utilisation

Activation

La compétence s'active automatiquement lorsque vous :

  • Utilisez la commande websh directement dans le terminal.
  • Naviguez dans une URL en utilisant la syntaxe de chemin de fichier (ex : cd http://example.com).
  • Traitez les URL comme des répertoires dans des commandes shell standard.

Commandes disponibles

CommandeDescriptionExemple
ls <url>Liste les ressources d'une page web (liens, images, scripts, styles)ls https://example.com
cd <url>Change le répertoire courant vers une URLcd https://example.com/docs
cat <url>Affiche le contenu textuel d'une page webcat https://example.com/about
grep <pattern> <url>Recherche un motif dans le contenu d'une page webgrep "API" https://example.com
pwdAffiche l'URL courante comme cheminpwd
head <url>Affiche les premières lignes d'une page webhead -n 10 https://example.com
tail <url>Affiche les dernières lignes d'une page webtail -n 5 https://example.com

Exemples

# Lister le contenu d'un site
ls https://jsonplaceholder.typicode.com

# Naviguer vers une API
cd https://api.github.com/repos/frames-engineering/websh

# Afficher le contenu d'une page
cat https://example.com

# Rechercher un texte spécifique
grep "installation" https://docs.python.org/3/

Installation

Ajoutez cette compétence à votre fichier de configuration d'agent IA :

{
  "skills": [
    "frames-engineering/websh"
  ]
}

Dépendances

  • curl ou wget pour les requêtes HTTP
  • pup ou htmlq pour l'analyse HTML (optionnel mais recommandé)
  • Environnement Unix/Linux ou WSL sur Windows

Notes

  • Les URL doivent être complètes (inclure le protocole).
  • Les pages nécessitant une authentification ou une session peuvent ne pas fonctionner correctement.
  • Le contenu dynamique (JavaScript) n'est pas exécuté ; seuls les éléments HTML statiques sont traités.
  • Pour une exploration avancée, combinez avec d'autres commandes Unix via des pipes (|).

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills associés