██████╗██╗     ██╗    ██████╗ ██████╗  ██████╗ ██╗    ██╗███████╗███████╗██████╗ 
  ██╔════╝██║     ██║    ██╔══██╗██╔══██╗██╔═══██╗██║    ██║██╔════╝██╔════╝██╔══██╗
  ██║     ██║     ██║    ██████╔╝██████╔╝██║   ██║██║ █╗ ██║███████╗█████╗  ██████╔╝
  ██║     ██║     ██║    ██╔══██╗██╔══██╗██║   ██║██║███╗██║╚════██║██╔══╝  ██╔══██╗
  ╚██████╗███████╗██║    ██████╔╝██║  ██║╚██████╔╝╚███╔███╔╝███████║███████╗██║  ██║
   ╚═════╝╚══════╝╚═╝    ╚═════╝ ╚═╝  ╚═╝ ╚═════╝  ╚══╝╚══╝ ╚══════╝╚══════╝╚═╝  ╚═╝

Terminal Internet — Browse the web entirely from your CLI

Features

• Web Search — Search via SearXNG with engine, category, and time filters
• Page Browsing — Render HTML pages as beautiful CLI text
• Reader Mode — Clean, distraction-free reading
• Tab Management — Multiple tabs with full navigation
• History & Bookmarks — Persistent across sessions
• Bang Commands — Quick access to YouTube, GitHub, Wikipedia, npm, etc.
• Developer Tools — Inspect frameworks, headers, cookies, security scan
• Downloads — Download files directly from the terminal
• Themes — Dark, Hacker, Minimal, Ocean, Sunset
• Plugin System — Extend with plugins
• Statistics — Track your browsing activity
• Autocomplete — Tab completion for all commands
• Network Controls — Proxy support, User-Agent switching

Installation

npm install -g cli-browser

Or run directly:

npx cli-browser

Quick Start

# Launch the browser
cli-browser

# Or use the short alias
cb

Commands

Search

search cats                        # Basic web search
s cats                             # Shortcut
search cats --engine google        # Use specific engine
search cats --engine duckduckgo    # DuckDuckGo
search cats --type image           # Image search
search cats --type video           # Video search  
search cats --type news            # News search
search ai news --time day          # Last 24 hours
search ai news --time week         # Last week
search ai --multi                  # Multi-category search
image cats                         # Quick image search

Browsing

open 1                             # Open search result #1
open https://example.com           # Open URL directly
link 3                             # Follow link #3 on page
reader                             # Reader mode (clean view)
info                               # Page metadata
source                             # View page HTML source
links                              # List all links on current page
find <text>                        # Find text on current page
top                                # Scroll to top of page
page 2                             # Go to search results page 2

Navigation

back                               # Go back (or 'b')
forward                            # Go forward (or 'f')
home                               # Home screen
refresh                            # Reload current page

Tabs

tab new                            # Create new tab
tab switch 2                       # Switch to tab 2
tab close 2                        # Close tab 2
tabs                               # List all tabs

History

history                            # View recent history
history open 2                     # Revisit entry #2
history clear                      # Clear all history

Bookmarks

bookmark add                       # Bookmark current page
bookmark list                      # List all bookmarks
bookmark open 1                    # Open bookmark #1
bookmark remove 1                  # Remove bookmark #1

Bang Commands

Quick-search specific sites:

!yt cats                           # YouTube
!gh react                          # GitHub
!wiki javascript                   # Wikipedia
!npm express                       # npm
!so async await                    # Stack Overflow
!reddit programming                # Reddit
!mdn fetch api                    # MDN Web Docs

Developer Tools

inspect                            # Detect frameworks & technologies
headers                            # View HTTP response headers
cookies                            # View page cookies
scan example.com                   # Full security scan
robots                             # View robots.txt
sitemap                            # View sitemap.xml
whois example.com                  # DNS lookup
resolve bit.ly/short               # Follow redirects to final URL
extract links                      # Extract all links
extract images                     # Extract all images
extract emails                     # Extract email addresses
extract headings                   # Extract headings
extract scripts                    # Extract scripts

Downloads

download https://example.com/f.zip # Download a file
downloads                          # List all downloads

AI Features

summary                            # Summarize current page
ask what is this page about        # Ask about page content

Themes

theme                              # List available themes
theme dark                         # Dark theme (default)
theme hacker                       # Green hacker theme
theme minimal                      # Clean minimal theme
theme ocean                        # Blue ocean theme
theme sunset                       # Red sunset theme

Network

proxy set 127.0.0.1:8080           # Set proxy
proxy clear                        # Remove proxy
ua chrome                          # Chrome user-agent
ua firefox                         # Firefox user-agent
ua mobile                          # Mobile user-agent

Sessions

login example.com                  # Save session cookies
session list                       # List saved sessions
session clear                      # Clear all sessions

Plugins

plugin list                        # List installed plugins
plugin install youtube             # Install plugin
plugin remove youtube              # Remove plugin

Statistics

stats                              # View browsing statistics

General

help                               # Show all commands
help search                        # Help for search commands
help browse                        # Help for browsing
help dev                           # Help for developer tools
clear                              # Clear screen
exit                               # Exit browser

Architecture

CLI Browser
   ↓
Search Engine (SearXNG)
   ↓
searxng.exe.xyz
   ↓
Web Pages → Rendered CLI Output

Project Structure

cli-browser/
├── bin/
│   └── cli-browser.js       # Entry point
├── src/
│   ├── index.js              # Main app / REPL
│   ├── browser.js            # Core browser engine
│   ├── search.js             # SearXNG search client
│   ├── renderer.js           # HTML → CLI renderer
│   ├── tabs.js               # Tab management
│   ├── history.js            # History management
│   ├── bookmarks.js          # Bookmark management
│   ├── developer.js          # Developer tools
│   ├── download.js           # Download manager
│   ├── network.js            # Proxy & UA manager
│   ├── themes.js             # Theme engine
│   ├── stats.js              # Statistics tracker
│   ├── bangs.js              # Bang commands
│   ├── plugins.js            # Plugin system
│   ├── sessions.js           # Session/cookie manager
│   ├── config.js             # Persistent configuration
│   └── ui.js                 # UI components
├── package.json
└── README.md

Workflow Example

$ cli-browser

▸ search javascript frameworks
  [1] React – A JavaScript library for building user interfaces
  [2] Vue.js – The Progressive JavaScript Framework
  [3] Angular – One framework for mobile & desktop

▸ open 1
  ══ React ══
  React is a free and open-source JavaScript library...
  Links:
  [1] Getting Started
  [2] Documentation
  [3] GitHub

▸ link 2
  ══ React Documentation ══
  ...

▸ bookmark add
  ✓ Bookmarked: React Documentation

▸ back
▸ tab new
▸ search node.js
▸ !gh react

Requirements

• Node.js >= 18.0.0
• Internet connection
• Terminal with Unicode support

License

MIT