websh

Browse and query web pages as a Unix-like filesystem with cached content.

1.7k|135|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/openprose/prose --skill websh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: websh
Source: https://github.com/openprose/prose/tree/main/skills/websh
Command: npx skills add https://github.com/openprose/prose --skill websh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Web browsing and data extraction are often manual, slow, and non-reproducible. The websh Skill solves this by turning the web into a Unix-like shell where URLs are navigable paths and content is queryable via commands.

Core Features & Use Cases

  • Async navigation: navigate to URLs with cd and see instant prompts while content is fetched in background.
  • Rich data caching: HTML is cached and progressively extracted into markdown for fast grep and grep-like searches.
  • Automation & discovery: supports ls, cat, grep, find, locate, and mounting APIs to automate workflows and content discovery.

Use Case: Build a reproducible workflow to fetch data from multiple sites, extract structured data, and save to local cache or export.

Quick Start

Start by launching websh, then run: "cd https://news.ycombinator.com" to explore Hacker News, then "ls" to see links, "grep 'AI'" to filter, "follow 1" to click a link, and "stat" to view page metadata.

Frequently Asked Questions about websh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate web data extraction and make it reproducible?

Automate web data extraction by navigating to URLs with cd, caching HTML content, and progressively extracting it into markdown for fast grep searches. You can build reproducible workflows to fetch data from multiple sites and save it to a local cache.

Can I browse and navigate live websites using a CLI interface?

Yes, you can browse live websites using a CLI interface by treating URLs as navigable paths. Commands like cd allow asynchronous background content fetching, while ls displays links and follow clicks them interactively.

What is the best way to search and filter cached web content locally?

Search and filter cached web content locally by using grep and grep-like commands on progressively extracted markdown. The cache index enables fast queries across fetched pages without repeatedly hitting live websites.

Does websh support crawling websites with configurable depth and domain constraints?

Yes, websh supports optional eager crawling with configurable depth and domain constraints. This allows controlled content discovery across websites and APIs while enforcing asynchronous background extraction.

How do I extract structured data and view page metadata from a website?

Extract structured data and view page metadata by navigating to a URL and running stat to see page information. Use find, locate, and cat to discover and capture specific content from the cached markdown.

Can I mount APIs and automate workflows across different web services?

Yes, you can mount APIs and automate workflows across different web services. websh exposes commands for navigation, search, and data capture, allowing you to interact with APIs as if navigating a Unix-like filesystem.