websh

Navigate URLs as directories with asynchronous fetch and cached content.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/chuwenWu/Auto-Company --skill websh-chuwenwu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: websh
Source: https://github.com/chuwenWu/Auto-Company/tree/main/.claude/skills/websh
Command: npx skills add https://github.com/chuwenWu/Auto-Company --skill websh-chuwenwu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Websh provides an interactive shell-like interface to browse the web by treating URLs as directories and page content as files, enabling instant exploration via caching and background fetch/extract.

Core Features & Use Cases

  • Asynchronous navigation: navigate to URLs with cd and query pages with ls, cat, and grep.
  • Background content extraction: fetch HTML and iteratively extract structured Markdown for quick viewing.
  • Instant navigation with caching: prompts return immediately while content loads in the background for later commands.

Quick Start

Start by navigating to a URL with cd, then list links with ls to explore the page.

Frequently Asked Questions about websh

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

FAQPage Schema
How do I browse web pages using command-line navigation?

Browse web pages using command-line navigation by treating URLs as directories and pages as files. You can use shell commands like cd to navigate to URLs and ls to list links for instant exploration.

Can I fetch and extract HTML content asynchronously in the background?

Yes, you can fetch and extract HTML content asynchronously in the background. Content is fetched via HTTP(S) and iteratively extracted into structured Markdown, while prompts return immediately for uninterrupted command-line navigation.

How does caching work for asynchronous web navigation?

Caching for asynchronous web navigation works by storing fetched HTML, parsed Markdown, and state in a cache/index system. This enables instant access to previously loaded pages and accelerates subsequent navigation.

Does websh work with any HTTP or HTTPS web content?

Websh works with any web content accessible via HTTP or HTTPS. It applies shell semantics to manage fetched HTML and parsed Markdown, requiring the websh shell environment and background tasks to operate.

What is the best way to explore links on a web page from the terminal?

The best way to explore links on a web page from the terminal is to navigate to the URL with cd, then use ls to list available links. You can also use cat or grep to query the extracted Markdown content directly.

Why does the shell prompt return immediately before the web page finishes loading?

The shell prompt returns immediately before the web page finishes loading because websh uses asynchronous background fetch tasks. This prevents blocking the terminal, allowing you to continue executing commands while content loads and caches.