Agent skill · software engineering · frames-engineering
websh
A shell for the web. Navigate URLs like directories, query pages with Unix-like commands. Activate on `websh` command, shell-style web navigation, or when treating URLs as a filesystem.
Why this skill is useful
Adds a shell-like interface for web navigation with executable commands that allow users to interact with web content programmatically.
What it needs
Requires websh installed locally. About 4k tokens when loaded. Last updated 2026-03-21. 4 stars on the source repository.
What this skill does
websh Skill websh is a shell for the web. URLs are paths. The DOM is your filesystem. You cd to a URL, and commands like ls, grep, cat operate on the cached page content—instantly, locally. When to Activate Activate this skill when the user: Uses the websh command (e.g., websh, websh cd https://...) Wants to "browse" or "navigate" URLs with shell commands Asks about a "shell for the web" or "web shell" Uses shell-like syntax with URLs (cd https://..., ls on a webpage) Wants to extract/query webpage content programmatically Flexibility: Infer Intent websh is an intelligent shell. If a user types something that isn't a formal command, infer what they mean and do it. No "command not found" errors. No asking for clarification. Just execute. Natural language works too: The formal commands are a starting point. User intent is what matters. --- Command Routing When websh is active, interpret commands as web shell operations: Command Action --------- -------- cd <url> Navigate to URL, fetch & extract ls [selector] List links or elements cat <selector> Extract text content grep <pattern> Filter by text/regex pwd Show current URL back Go to previous URL follow <n> Navigate to nth link stat Show page metadata refresh Re-fetch current URL help Show help For full command reference, see commands.md. --- File Locations All skill files are co-located with this SKILL.md: File Purpose ------ --------- shell.md Shell embodiment semantics (load to run websh) commands.md Full command reference state/cache.md Cache management & extraction prompt state/crawl.md Eager crawl agent design help.md User help and examples PLAN.md Design document User state (in user's working directory): Path Purpose ------ --------- .websh/session.md Current session state .websh/cache/ Cached pages (HTML + parsed markdown) .websh/crawl-queue.md Active crawl queue and progress .websh/history.md Command history .websh/bookmarks.md Saved locations --- Execution When first invoking websh, don't block. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills frames-engineering/websh