cli-browser 1.0.0

package/README.md

@@ -0,0 +1,309 @@
+<div align="center">
+
+```
+   ██████╗██╗     ██╗    ██████╗ ██████╗  ██████╗ ██╗    ██╗███████╗███████╗██████╗ 
+  ██╔════╝██║     ██║    ██╔══██╗██╔══██╗██╔═══██╗██║    ██║██╔════╝██╔════╝██╔══██╗
+  ██║     ██║     ██║    ██████╔╝██████╔╝██║   ██║██║ █╗ ██║█████╗  █████╗  ██████╔╝
+  ██║     ██║     ██║    ██╔══██╗██╔══██╗██║   ██║██║███╗██║██╔══╝  ██╔══╝  ██╔══██╗
+  ╚██████╗███████╗██║    ██████╔╝██║  ██║╚██████╔╝╚███╔███╔╝███████╗███████╗██║  ██║
+   ╚═════╝╚══════╝╚═╝    ╚═════╝ ╚═╝  ╚═╝ ╚═════╝  ╚══╝╚══╝ ╚══════╝╚══════╝╚═╝  ╚═╝
+```
+
+### **Terminal Internet** — Browse the web entirely from your CLI
+
+[![npm version](https://img.shields.io/npm/v/cli-browser.svg)](https://www.npmjs.com/package/cli-browser)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org)
+
+</div>
+
+---
+
+## 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
+
+```bash
+npm install -g cli-browser
+```
+
+Or run directly:
+
+```bash
+npx cli-browser
+```
+
+---
+
+## Quick Start
+
+```bash
+# Launch the browser
+cli-browser
+
+# Or use the short alias
+cb
+```
+
+---
+
+## Commands
+
+### Search
+
+```bash
+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
+
+```bash
+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
+```
+
+### Navigation
+
+```bash
+back                               # Go back (or 'b')
+forward                            # Go forward (or 'f')
+home                               # Home screen
+refresh                            # Reload current page
+```
+
+### Tabs
+
+```bash
+tab new                            # Create new tab
+tab switch 2                       # Switch to tab 2
+tab close 2                        # Close tab 2
+tabs                               # List all tabs
+```
+
+### History
+
+```bash
+history                            # View recent history
+history open 2                     # Revisit entry #2
+history clear                      # Clear all history
+```
+
+### Bookmarks
+
+```bash
+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:
+
+```bash
+!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
+
+```bash
+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
+```
+
+### Downloads
+
+```bash
+download https://example.com/f.zip # Download a file
+downloads                          # List all downloads
+```
+
+### AI Features
+
+```bash
+summary                            # Summarize current page
+ask what is this page about        # Ask about page content
+```
+
+### Themes
+
+```bash
+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
+
+```bash
+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
+
+```bash
+login example.com                  # Save session cookies
+session list                       # List saved sessions
+session clear                      # Clear all sessions
+```
+
+### Plugins
+
+```bash
+plugin list                        # List installed plugins
+plugin install youtube             # Install plugin
+plugin remove youtube              # Remove plugin
+```
+
+### Statistics
+
+```bash
+stats                              # View browsing statistics
+```
+
+### General
+
+```bash
+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
+
+```bash
+$ 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

package/bin/cli-browser.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { startBrowser } from '../src/index.js';
+
+startBrowser().catch(err => {
+  console.error('Failed to start CLI Browser:', err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "cli-browser",
+  "version": "1.0.0",
+  "description": "A powerful Terminal Internet browser — search, browse, navigate, and explore the web entirely from your CLI",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "cli-browser": "./bin/cli-browser.js",
+    "cb": "./bin/cli-browser.js"
+  },
+  "scripts": {
+    "start": "node bin/cli-browser.js",
+    "dev": "node --watch bin/cli-browser.js"
+  },
+  "keywords": [
+    "cli",
+    "browser",
+    "terminal",
+    "web",
+    "search",
+    "searxng",
+    "terminal-browser",
+    "cli-browser",
+    "web-browser",
+    "text-browser"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.7.0",
+    "chalk": "^5.3.0",
+    "cheerio": "^1.0.0",
+    "cli-table3": "^0.6.5",
+    "conf": "^13.0.0",
+    "ora": "^8.0.0",
+    "boxen": "^8.0.0",
+    "figures": "^6.0.0",
+    "wrap-ansi": "^9.0.0",
+    "string-width": "^7.0.0",
+    "cli-highlight": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md"
+  ]
+}

package/src/bangs.js

@@ -0,0 +1,53 @@
+import config from './config.js';
+
+class BangCommands {
+  constructor() {
+    this.commands = config.get('bangCommands');
+  }
+
+  isBang(input) {
+    return input.startsWith('!');
+  }
+
+  parse(input) {
+    const parts = input.split(/\s+/);
+    const bang = parts[0];
+    const query = parts.slice(1).join(' ');
+    return { bang, query };
+  }
+
+  getUrl(bang, query) {
+    const baseUrl = this.commands[bang];
+    if (!baseUrl) return null;
+    return baseUrl + encodeURIComponent(query);
+  }
+
+  listBangs() {
+    const bangMap = {
+      '!yt': 'YouTube',
+      '!gh': 'GitHub',
+      '!wiki': 'Wikipedia',
+      '!npm': 'npm',
+      '!so': 'Stack Overflow',
+      '!reddit': 'Reddit',
+      '!mdn': 'MDN Web Docs',
+      '!twitter': 'Twitter/X',
+      '!amazon': 'Amazon',
+      '!maps': 'Google Maps',
+    };
+
+    return Object.entries(this.commands).map(([bang, url]) => ({
+      bang,
+      name: bangMap[bang] || url,
+      url,
+    }));
+  }
+
+  addBang(bang, url) {
+    if (!bang.startsWith('!')) bang = '!' + bang;
+    this.commands[bang] = url;
+    config.set('bangCommands', this.commands);
+  }
+}
+
+export default new BangCommands();

package/src/bookmarks.js

@@ -0,0 +1,45 @@
+import config from './config.js';
+
+class BookmarkManager {
+  add(title, url) {
+    const bookmarks = config.get('bookmarks') || [];
+    const exists = bookmarks.find(b => b.url === url);
+    if (exists) {
+      throw new Error('Already bookmarked');
+    }
+    const item = {
+      id: Date.now(),
+      title,
+      url,
+      createdAt: new Date().toISOString(),
+    };
+    bookmarks.push(item);
+    config.set('bookmarks', bookmarks);
+    return item;
+  }
+
+  getAll() {
+    return config.get('bookmarks') || [];
+  }
+
+  getByIndex(idx) {
+    const bookmarks = this.getAll();
+    return bookmarks[idx - 1] || null;
+  }
+
+  remove(idx) {
+    const bookmarks = this.getAll();
+    if (idx < 1 || idx > bookmarks.length) {
+      throw new Error('Invalid bookmark index');
+    }
+    const removed = bookmarks.splice(idx - 1, 1);
+    config.set('bookmarks', bookmarks);
+    return removed[0];
+  }
+
+  clear() {
+    config.set('bookmarks', []);
+  }
+}
+
+export default new BookmarkManager();