Websh

What it does

Websh is a unique "shell for the web," allowing an AI agent to interact with websites as if they were filesystems. It enables navigation and data extraction from webpages using familiar shell commands like cd, ls, grep, and cat. The skill caches webpage content locally, providing instant access and enabling programmatic querying of information on the internet.

When to use it

• When you want to "browse" or navigate URLs using shell-like commands.
• To extract specific text content from a webpage.
• To filter webpage content based on patterns (e.g., searching for keywords).
• When programmatically querying and analyzing data found on websites.
• If the user explicitly asks for a "shell for the web" or similar terminology.

Key capabilities

• URL Navigation: cd <url> to change directories and fetch webpage content.
• Listing Content: ls [selector] to list links or elements within a page.
• Content Extraction: cat <selector> to extract text from specific elements.
• Filtering: grep <pattern> to filter content based on text patterns.
• History & Bookmarks: Maintains command history and allows saving locations as bookmarks.
• Intent Inference: Understands natural language commands and variations of formal shell syntax.

Example prompts

• "websh cd https://news.ycombinator.com"
• "show me the first 5 links on this page"
• "grep 'AI' on the current webpage"

Tips & gotchas

• Websh prioritizes user intent; it will attempt to execute commands even if they aren’t perfectly formatted, avoiding error messages.
• The skill caches webpages locally for faster access. Use refresh to re-fetch the current page.
• Refer to the commands.md file for a complete list of available commands and their usage.