termsearch 0.3.7 → 0.3.9

package/README.md

@@ -1,187 +1,167 @@
-# TermSearch - Personal Search Engine
+# TermSearch
 
-[![Status](https://img.shields.io/badge/Status-0.3.3-blue.svg)](#project-status)
+[![Version](https://img.shields.io/badge/version-0.3.8-blue.svg)](#)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Node.js](https://img.shields.io/badge/Node.js-18%2B-green.svg)](https://nodejs.org)
-[![Target](https://img.shields.io/badge/Target-Termux%20%2F%20Linux%20%2F%20macOS-green.svg)](https://termux.dev)
+[![Platform](https://img.shields.io/badge/Termux%20%7C%20Linux%20%7C%20macOS-green.svg)](#)
 [![npm](https://img.shields.io/badge/npm-termsearch-red.svg)](https://www.npmjs.com/package/termsearch)
 
-TermSearch is a privacy-first personal search engine installable with a single command on Termux, Linux, and macOS.
-Zero external dependencies, no Docker, no Python. AI is optional and configured entirely from the browser.
+**Personal search engine.** One command install, zero config, privacy-first.
 
-Core capabilities:
+No Docker, no Python, no API keys required. AI is optional. Everything runs from a single `npm install`.
 
-- Zero-config search via DuckDuckGo and Wikipedia — works immediately after install
-- Built-in GitHub Search API fallback (`github-api`) and selectable engine mix from UI
-- Progressive enhancement: add Brave/Mojeek API keys, AI endpoints, or SearXNG when needed
-- Search history persistence (opt-in toggle in Settings)
-- Social profile scanner: GitHub, Bluesky, Reddit, Twitter/X, Instagram, YouTube, LinkedIn, TikTok, Telegram, Facebook
-- Torrent search: The Pirate Bay + 1337x with direct magnet extraction
-- Social search: Bluesky posts/actors + GDELT news
-- AI-powered 2-phase agentic summaries via any OpenAI-compatible endpoint
-- Vanilla HTML/CSS/JS frontend (~280KB, no build step, no framework)
-- Boot autostart: Termux:Boot, systemd --user, or launchd (macOS)
+## Install & Run
 
-## Project Status
+```bash
+npm install -g termsearch
+termsearch
+```
 
-- Current line: `0.3.3`
-- Core is MIT — zero required API keys
-- AI features are optional, configured via Settings page in browser
-- Tested on: Ubuntu 24.04, Termux (Android 15/16)
-- macOS: compatible (launchd autostart), untested in production
+Opens `http://localhost:3000`. That's it.
 
-## Quickstart
+## What You Get
 
-1. Install globally
+**Search** — DuckDuckGo + Wikipedia out of the box. Add Brave, Mojeek, Yandex, Marginalia, Ahmia, or your own SearXNG for more coverage. Engine picker lets you mix and match per-search.
 
-```bash
-npm install -g termsearch
-```
+**AI Summaries** — Connect any OpenAI-compatible endpoint (Ollama, LM Studio, llama.cpp, Chutes.ai, Anthropic, OpenAI). 2-phase agentic flow: AI picks sources, reads pages, synthesizes an answer. Session memory carries context across queries.
 
-2. Start
+**Social Profiler** — Paste a GitHub/Bluesky/Reddit/Twitter URL or @handle, get a profile card with stats, top repos, similar accounts.
 
-```bash
-termsearch
-```
+**Torrent Search** — The Pirate Bay + 1337x with magnet links, seeders, file sizes.
 
-3. Open browser at `http://localhost:3000`
+**Social & News** — Bluesky posts + GDELT articles inline.
 
-That's it. No configuration required for basic search.
+## Progressive Enhancement
+
+| Level | Config | What works |
+|-------|--------|------------|
+| **0** | None | DuckDuckGo + Wikipedia + Yandex + Marginalia + Ahmia |
+| **1** | API keys (Settings) | + Brave, Mojeek |
+| **2** | AI endpoint (Settings) | + AI summaries, query refinement, session memory |
+| **3** | SearXNG URL | + 40 engines via your SearXNG instance |
 
 ## CLI
 
-```bash
-termsearch                     # start + open browser (if not running: status)
-termsearch start               # start server in background
-termsearch start --fg          # start in foreground (debug/logs live)
-termsearch stop                # stop background server
-termsearch restart             # restart
-termsearch status              # show PID, URL, uptime
-termsearch doctor              # check Node version, data dir, HTTP health
-termsearch logs                # last 60 lines of server log
-termsearch logs -n 100         # last N lines
-termsearch open                # open browser
-termsearch autostart enable    # start at boot (Termux:Boot / systemd / launchd)
-termsearch autostart disable   # disable autostart
-termsearch help                # full command reference
+```
+termsearch                     start + open browser
+termsearch start               background daemon
+termsearch start --fg          foreground (live logs)
+termsearch stop / restart      manage daemon
+termsearch status              version, PID, URL, update check
+termsearch doctor              full health check + npm update check
+termsearch logs [-n 100]       server log tail
+termsearch open                open browser
+termsearch autostart enable    boot start (Termux:Boot / systemd / launchd)
+termsearch help                full reference
 ```
 
-Options:
+Options: `--port=3000` `--host=127.0.0.1` `--data-dir=~/.termsearch/`
 
-```bash
---port=<port>                  # default: 3000
---host=<host>                  # default: 127.0.0.1
---data-dir=<path>              # default: ~/.termsearch/
-```
+## AI Presets
 
-## Progressive Enhancement
+Configure in **Settings > AI** from the browser. Presets auto-fill endpoint and model:
+
+| Preset | Endpoint | Key | Default Model |
+|--------|----------|-----|---------------|
+| Ollama | `localhost:11434/v1` | no | `qwen3.5:4b` |
+| LM Studio | `localhost:1234/v1` | no | — |
+| llama.cpp | `localhost:8080/v1` | no | — |
+| Chutes.ai TEE | `llm.chutes.ai/v1` | yes | `DeepSeek-V3.2-TEE` |
+| Anthropic | `api.anthropic.com/v1` | yes | `claude-3-5-haiku-latest` |
+| OpenAI | `api.openai.com/v1` | yes | `gpt-4o-mini` |
+| Custom | any OpenAI-compatible | optional | — |
+
+Load Models button auto-discovers available models from the endpoint.
+
+## Search Engines
+
+**Zero-config** (no API key): DuckDuckGo, Wikipedia, GitHub, Yandex, Ahmia, Marginalia
 
-| Level | Requirements | Features |
-|-------|-------------|---------|
-| **0** (zero-config) | None | DuckDuckGo + Wikipedia — works immediately |
-| **1** (API keys) | Brave/Mojeek key via Settings | Better and more diverse results |
-| **2** (AI) | Any OpenAI-compatible endpoint | Summaries, query refinement |
-| **3** (power user) | Own SearXNG instance | 40+ search engines |
+**API key** (toggle in Settings): Brave Search, Mojeek
 
-## AI Configuration
+**Self-hosted**: SearXNG (proxy to 40+ engines)
 
-Configure at **Settings → AI** in the browser. Supported endpoints:
+**Selectable per-search**: Engine picker icon in the header lets you toggle individual engines, use presets (All / Balanced / GitHub Focus), or pick from groups (Web Core, Uncensored, Code & Dev, Media, Research, Federated, Torrent).
 
-| Provider | API Base | Model | Key |
-|----------|----------|-------|-----|
-| **Localhost** (Ollama) | `http://localhost:11434/v1` | `qwen3.5:4b` or any | not required |
-| **Localhost** (LM Studio) | `http://localhost:1234/v1` | your loaded model | not required |
-| **Localhost** (llama.cpp) | `http://localhost:8080/v1` | your loaded model | not required |
-| **Chutes.ai TEE** | `https://llm.chutes.ai/v1` | `deepseek-ai/DeepSeek-V3.2-TEE` | required |
-| **Anthropic** | `https://api.anthropic.com/v1` | `claude-3-5-haiku-latest` | required |
-| **OpenAI** | `https://api.openai.com/v1` | `gpt-4o-mini` | required |
-| **OpenRouter** | `https://openrouter.ai/api/v1` | any listed model | required |
-| **API custom** | any OpenAI-compatible URL | your model | optional |
+## Frontend
 
-All providers use the OpenAI-compatible `/chat/completions` format. Leave API key empty for local models.
+Vanilla HTML/CSS/JS — ~350KB total, no build step, no framework, no WASM.
+
+- Dark/light theme toggle
+- Mobile-first responsive layout with bottom bar
+- PWA manifest + OpenSearch integration
+- AI panel with progress bar, steps, source pills, session memory, retry
+- Engine picker as compact icon with dropdown
 
 ## Architecture
 
 ```
 ~/.termsearch/
-  config.json       user settings (saved via browser Settings page)
-  cache/            search + document cache (L1 RAM + L2 disk)
-  termsearch.pid    daemon PID
-  termsearch.log    server log
+  config.json          settings (saved via browser UI)
+  cache/               L1 RAM + L2 disk cache
+  termsearch.pid       daemon PID
+  termsearch.log       server log
 
 src/
-  config/           config manager — load/save/defaults/env overrides
+  server.js            Express app (~70 lines)
+  config/              manager + defaults + env overrides
   search/
-    providers/      DuckDuckGo, Wikipedia, Brave, Mojeek, SearXNG, GitHub API, Yandex, Ahmia, Marginalia
-    engine.js       fan-out, merge, rank, cache
-    ranking.js      source diversity ranking
-    cache.js        tiered cache (L1 Map + L2 disk JSON)
-  fetch/
-    document.js     URL fetcher + HTML → readable text + site scan
-    ssrf-guard.js   SSRF protection
+    engine.js          fan-out, merge, rank, health tracking
+    providers/         ddg, wikipedia, brave, mojeek, searxng, github, yandex, ahmia, marginalia
+    ranking.js         source diversity ranking
+    cache.js           tiered L1+L2 cache
   ai/
-    orchestrator.js 2-phase agentic summary flow
-    summary.js      prompt builder + response parser
-    query.js        query refinement
-    providers/
-      openai-compat.js  universal OpenAI-compatible client
-  profiler/
-    scanner.js      social profile scanner (10 platforms)
-  social/
-    scrapers.js     Twitter/Nitter, Instagram, YouTube, Facebook, LinkedIn, TikTok, Telegram
-    search.js       Bluesky posts/actors + GDELT news
-  torrent/
-    scrapers.js     TPB + 1337x scrapers + magnet extraction
-  autostart/
-    manager.js      boot autostart (Termux:Boot / systemd / launchd)
-  api/
-    routes.js       all API route handlers
-    middleware.js   rate limiting, security headers
-  server.js         Express app setup
-
-frontend/dist/      vanilla HTML/CSS/JS SPA (~280KB, no build step)
+    orchestrator.js    2-phase agentic summary
+    summary.js         prompt builder + parser
+    query.js           query refinement
+    providers/         openai-compat universal client
+  fetch/               document fetcher + SSRF guard
+  profiler/            social profile scanner (10 platforms)
+  social/              Bluesky + GDELT + scrapers
+  torrent/             TPB + 1337x + magnet extraction
+  autostart/           Termux:Boot / systemd / launchd
+  api/                 routes + middleware
+
+frontend/dist/         vanilla SPA
 ```
 
 ## API
 
 ```
-GET  /api/health                     service status + enabled providers
-GET  /api/openapi.json               machine-readable API description
-GET  /api/search?q=...               web search
-GET  /api/search-stream?q=...        progressive SSE search
-POST /api/fetch                      fetch readable content from URL
-POST /api/ai-query                   AI query refinement
-POST /api/ai-summary                 AI summary with SSE streaming
-GET  /api/profiler?q=...             social profile scan (URL or @handle)
-GET  /api/social-search?q=...        Bluesky + GDELT news
-POST /api/torrent-search             torrent search (TPB + 1337x)
-POST /api/magnet                     extract magnet from torrent page URL
-POST /api/scan                       crawl site for query-matched pages
-GET  /api/config                     current config (keys masked)
-POST /api/config                     update and persist config
-POST /api/config/test-ai             test AI connection
-GET  /api/config/test-provider/:name test search provider
-GET  /api/autostart                  autostart status
-POST /api/autostart                  enable/disable autostart
-GET  /api/stats                      usage stats
+GET  /api/health                    status + providers
+GET  /api/search?q=...              search (JSON)
+GET  /api/search-stream?q=...       progressive search (SSE)
+POST /api/ai-summary                AI summary (SSE streaming)
+POST /api/ai-query                  AI query refinement
+POST /api/fetch                     fetch readable content
+GET  /api/profiler?q=...            social profile scan
+GET  /api/social-search?q=...       Bluesky + GDELT
+POST /api/torrent-search            torrent scrape
+POST /api/magnet                    magnet extraction
+POST /api/scan                      site crawl
+GET  /api/config                    config (keys masked)
+POST /api/config                    update config
+POST /api/config/test-ai            test AI connection
+POST /api/config/models             list provider models
+GET  /api/config/test-provider/:id  test search provider
+GET  /api/autostart                 autostart status
+POST /api/autostart                 toggle autostart
+GET  /api/openapi.json              OpenAPI spec
 ```
 
-## Environment Variables (optional, override Settings)
+## Env Vars (optional)
 
 ```bash
 TERMSEARCH_PORT=3000
 TERMSEARCH_HOST=127.0.0.1
 TERMSEARCH_DATA_DIR=~/.termsearch/
-TERMSEARCH_AI_API_BASE=https://api.z.ai/api/coding/paas/v4
+TERMSEARCH_AI_API_BASE=http://localhost:11434/v1
 TERMSEARCH_AI_API_KEY=
-TERMSEARCH_AI_MODEL=glm-4.7
+TERMSEARCH_AI_MODEL=qwen3.5:4b
 TERMSEARCH_BRAVE_API_KEY=
 TERMSEARCH_MOJEEK_API_KEY=
 TERMSEARCH_MARGINALIA_API_KEY=public
-TERMSEARCH_MARGINALIA_API_BASE=https://api2.marginalia-search.com
 TERMSEARCH_SEARXNG_URL=
-TERMSEARCH_GITHUB_TOKEN=
-TERMSEARCH_INSTAGRAM_SESSION=
 ```
 
 ## Termux
@@ -190,23 +170,9 @@ TERMSEARCH_INSTAGRAM_SESSION=
 pkg install nodejs
 npm install -g termsearch
 termsearch
+termsearch autostart enable   # optional: start on boot
 ```
 
-Enable autostart with Termux:Boot (install from F-Droid):
-
-```bash
-termsearch autostart enable
-```
-
-## Roadmap
-
-1. Persistent search stats counter
-2. Engine health tracking and failure classification
-3. Frontend profile viewer panel
-4. Frontend torrent results panel with magnet copy
-5. Agentic user-proxy (`/api/user-proxy`) for custom AI loops
-6. Packaged release on npm registry
-
 ## License
 
 MIT — Copyright (c) 2026 Davide A. Guglielmi

package/bin/termsearch.js

@@ -32,7 +32,7 @@ function info(msg) { console.log(`  ${CYAN}→${RESET} ${msg}`); }
 
 // ─── Package version ──────────────────────────────────────────────────────
 
-let VERSION = '0.3.1';
+let VERSION = '0.3.8';
 try { VERSION = JSON.parse(readFileSync(PKG_PATH, 'utf8')).version || VERSION; } catch { /* ignore */ }
 
 // ─── Data dir + paths ─────────────────────────────────────────────────────

package/frontend/dist/app.js

@@ -268,7 +268,6 @@ const AI_PRESETS = [
   { id: 'chutes',   label: 'Chutes.ai TEE',            api_base: 'https://llm.chutes.ai/v1',  keyRequired: true,  defaultModel: 'deepseek-ai/DeepSeek-V3.2-TEE' },
   { id: 'anthropic',label: 'Anthropic',                api_base: 'https://api.anthropic.com/v1', keyRequired: true, defaultModel: 'claude-3-5-haiku-latest' },
   { id: 'openai',   label: 'OpenAI',                   api_base: 'https://api.openai.com/v1', keyRequired: true,  defaultModel: 'gpt-4o-mini' },
-  { id: 'openrouter', label: 'OpenRoute/OpenRouter',   api_base: 'https://openrouter.ai/api/v1', keyRequired: true, defaultModel: 'openai/gpt-4o-mini' },
 ];
 
 const ENGINE_GROUPS = [
@@ -387,6 +386,20 @@ function EnginePicker(opts = {}) {
   ));
 
   details.append(summary, body);
+
+  // Close on click-outside
+  details.addEventListener('toggle', () => {
+    if (!details.open) return;
+    const onClickOutside = (e) => {
+      if (!details.contains(e.target)) {
+        details.open = false;
+        document.removeEventListener('click', onClickOutside, true);
+      }
+    };
+    // Defer to avoid catching the same click that opened it
+    requestAnimationFrame(() => document.addEventListener('click', onClickOutside, true));
+  });
+
   return details;
 }
 
@@ -1029,7 +1042,7 @@ function renderApp() {
     el('div', { className: 'header-nav' },
       LangPicker(),
       EnginePicker({ compact: true }),
-      el('button', { className: 'btn-icon', title: 'Settings',     onClick: () => navigate('#/settings') }, iconEl('settings')),
+      el('button', { className: 'btn-icon', title: 'Settings', onClick: () => navigate('#/settings') }, iconEl('settings')),
       el('button', { className: 'btn-icon', title: 'Toggle theme', onClick: toggleTheme }, iconEl('theme')),
     ),
   );
@@ -1067,9 +1080,11 @@ function renderApp() {
         onClick: () => { state.query = ''; state.category = 'web'; navigate('#/'); renderApp(); },
       }, 'Term', el('strong', {}, 'Search')),
       LangPicker(),
-      EnginePicker({ compact: true }),
-      el('button', { className: 'btn-icon', title: 'Settings',     onClick: () => navigate('#/settings') }, iconEl('settings')),
-      el('button', { className: 'btn-icon', title: 'Toggle theme', onClick: toggleTheme }, iconEl('theme')),
+      el('div', { className: 'mobile-bar-actions' },
+        EnginePicker({ compact: true }),
+        el('button', { className: 'btn-icon', title: 'Settings',     onClick: () => navigate('#/settings') }, iconEl('settings')),
+        el('button', { className: 'btn-icon', title: 'Toggle theme', onClick: toggleTheme }, iconEl('theme')),
+      ),
     ),
   );
 
@@ -1122,6 +1137,38 @@ function renderApp() {
 }
 
 // ─── Homepage ─────────────────────────────────────────────────────────────
+function addToBrowser() {
+  // Try legacy Firefox API
+  try {
+    if (window.external?.AddSearchProvider) {
+      window.external.AddSearchProvider(location.origin + '/opensearch.xml');
+      return;
+    }
+  } catch {}
+  // Show inline hint
+  const existing = document.querySelector('.add-browser-hint');
+  if (existing) { existing.remove(); return; }
+  const searchUrl = `${location.origin}/#/?q=%s`;
+  const urlBox = el('div', { className: 'add-browser-url' });
+  const urlText = el('code', {}, searchUrl);
+  const copyBtn = el('button', { className: 'add-browser-copy', type: 'button', onClick: () => {
+    navigator.clipboard.writeText(searchUrl).then(() => { copyBtn.textContent = 'Copied!'; setTimeout(() => { copyBtn.textContent = 'Copy'; }, 2000); }).catch(() => {});
+  } }, 'Copy');
+  urlBox.append(urlText, copyBtn);
+  const hint = el('div', { className: 'add-browser-hint' },
+    el('div', { className: 'add-browser-title' }, 'Add TermSearch to your browser'),
+    el('div', { className: 'add-browser-steps' },
+      el('div', {}, el('span', { className: 'add-browser-badge' }, 'Firefox'), ' Address bar → click TermSearch icon → "Add"'),
+      el('div', {}, el('span', { className: 'add-browser-badge' }, 'Chrome'), ' Settings → Search engine → Manage → Add'),
+      el('div', {}, el('span', { className: 'add-browser-badge' }, 'Safari'), ' Not natively supported — use extension or bookmark'),
+    ),
+    el('div', { className: 'add-browser-label' }, 'Search URL (paste in browser settings):'),
+    urlBox,
+  );
+  document.querySelector('.home-actions')?.after(hint);
+  setTimeout(() => hint.remove(), 20000);
+}
+
 function renderHome(app) {
   const home = el('div', { className: 'home' },
     el('div', { className: 'home-logo' }, 'Term', el('strong', {}, 'Search')),
@@ -1134,6 +1181,8 @@ function renderHome(app) {
       LangPicker(),
       el('button', { className: 'btn', onClick: () => navigate('#/settings') }, iconEl('settings'), ' Settings'),
       el('button', { className: 'btn', onClick: toggleTheme }, iconEl('theme'), ' Theme'),
+      el('button', { className: 'btn', onClick: addToBrowser, title: 'Add as browser search engine' }, iconEl('search'), ' Add to browser'),
+      el('a', { className: 'btn', href: 'https://github.com/DioNanos/termsearch', target: '_blank', rel: 'noopener noreferrer' }, iconEl('github'), ' GitHub'),
     ),
   );
 
@@ -1483,7 +1532,7 @@ async function renderSettings() {
         el('label', { className: 'form-label', for: 'ai-base' }, 'API Endpoint'),
         makeInput('ai-base', ai.api_base, 'http://localhost:11434/v1'),
         el('div', { className: 'form-hint' },
-          'Included presets: LocalHost (Ollama · LM Studio · llama.cpp) · Chutes.ai TEE · Anthropic · OpenAI · OpenRoute/OpenRouter',
+          'Included presets: LocalHost (Ollama · LM Studio · llama.cpp) · Chutes.ai TEE · Anthropic · OpenAI',
           el('br', {}),
           'You can also keep custom OpenAI-compatible endpoints.',
         ),
@@ -1627,7 +1676,7 @@ async function renderSettings() {
     // Server info
     el('div', { className: 'settings-section' },
       el('h2', {}, 'Server Info'),
-      el('div', { className: 'info-row' }, el('span', { className: 'info-key' }, 'Version'),          el('span', { className: 'info-val' }, health?.version || '0.3.3')),
+      el('div', { className: 'info-row' }, el('span', { className: 'info-key' }, 'Version'),          el('span', { className: 'info-val' }, health?.version || '0.3.8')),
       el('div', { className: 'info-row' }, el('span', { className: 'info-key' }, 'Active providers'), el('span', { className: 'info-val' }, (health?.providers || []).join(', ') || 'none')),
       el('div', { className: 'info-row' }, el('span', { className: 'info-key' }, 'AI'),               el('span', { className: 'info-val' }, health?.ai_enabled ? `enabled (${health.ai_model})` : 'not configured')),
       el('div', { className: 'info-row' }, el('span', { className: 'info-key' }, 'GitHub'),           el('a', { href: 'https://github.com/DioNanos/termsearch', target: '_blank', className: 'info-val', style: 'color:var(--link)' }, 'DioNanos/termsearch')),

package/frontend/dist/style.css

@@ -189,12 +189,13 @@ a:hover { color: var(--link-h); }
   justify-content: center;
   background: transparent;
   color: var(--text3);
-  border-color: var(--border);
+  border: 1px solid transparent;
   position: relative;
+  cursor: pointer;
+  transition: color 0.15s;
 }
 .engine-picker-summary-icon:hover {
-  border-color: #3a3a3a;
-  color: var(--text2);
+  color: var(--text);
 }
 .engine-filter-icon {
   display: inline-flex;
@@ -934,6 +935,85 @@ a:hover { color: var(--link-h); }
 /* ─── No results ──────────────────────────────────────────────────────────── */
 .no-results { text-align: center; padding: 40px 20px; color: var(--text3); font-size: 14px; }
 
+/* ─── Add to browser hint ─────────────────────────────────────────────────── */
+.add-browser-hint {
+  max-width: 420px;
+  margin: 20px auto 0;
+  padding: 16px 20px;
+  border-radius: var(--radius);
+  background: rgba(30,27,75,0.45);
+  border: 1px solid rgba(109,40,217,0.35);
+  color: var(--text2);
+  font-size: 12px;
+  line-height: 1.7;
+  animation: fadeIn 0.2s ease;
+}
+.add-browser-title {
+  font-size: 13px;
+  font-weight: 700;
+  color: var(--text);
+  margin-bottom: 10px;
+}
+.add-browser-steps {
+  display: flex;
+  flex-direction: column;
+  gap: 5px;
+  margin-bottom: 12px;
+}
+.add-browser-badge {
+  display: inline-block;
+  padding: 1px 7px;
+  border-radius: 99px;
+  font-size: 10px;
+  font-weight: 700;
+  background: rgba(167,139,250,0.18);
+  color: #a78bfa;
+  border: 1px solid rgba(167,139,250,0.3);
+  letter-spacing: 0.02em;
+}
+.add-browser-label {
+  font-size: 10px;
+  color: var(--text3);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  margin-bottom: 6px;
+}
+.add-browser-url {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 12px;
+  border-radius: var(--radius-sm);
+  background: rgba(0,0,0,0.4);
+  border: 1px solid rgba(167,139,250,0.25);
+}
+.add-browser-url code {
+  flex: 1;
+  min-width: 0;
+  font-family: var(--font-mono);
+  font-size: 12px;
+  font-weight: 600;
+  color: #c4b5fd;
+  word-break: break-all;
+  user-select: all;
+}
+.add-browser-copy {
+  flex-shrink: 0;
+  padding: 4px 12px;
+  border-radius: var(--radius-sm);
+  border: 1px solid rgba(167,139,250,0.35);
+  background: rgba(109,40,217,0.25);
+  color: #e0d4fd;
+  font-size: 11px;
+  font-weight: 600;
+  cursor: pointer;
+  transition: background 0.15s, border-color 0.15s;
+}
+.add-browser-copy:hover {
+  background: rgba(109,40,217,0.45);
+  border-color: rgba(167,139,250,0.55);
+}
+
 /* ─── Footer ──────────────────────────────────────────────────────────────── */
 .footer {
   border-top: 1px solid var(--border2);
@@ -1005,6 +1085,12 @@ a:hover { color: var(--link-h); }
   padding: 4px 12px 2px;
 }
 .mobile-bar-row .lang-wrap { margin-left: auto; }
+.mobile-bar-actions {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  flex-shrink: 0;
+}
 
 /* ─── Responsive ──────────────────────────────────────────────────────────── */
 @media (max-width: 640px) {
@@ -1014,6 +1100,7 @@ a:hover { color: var(--link-h); }
 
   .cat-tab { font-size: 10px; padding: 4px 8px; }
   .mobile-bar-row .engine-picker-summary-icon { width: 30px; height: 30px; }
+  .mobile-bar-actions .engine-picker-summary-icon { width: 30px; height: 30px; }
   .engine-picker-body {
     position: fixed;
     left: 10px;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termsearch",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "Personal search engine for Termux/Linux/macOS — zero-config, privacy-first, AI-optional",
   "type": "module",
   "bin": {

package/src/api/routes.js

@@ -1,6 +1,9 @@
 // All API route handlers
 
 import express from 'express';
+import { readFileSync } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
 import { search, searchStream, getEnabledProviders, getDocCache, ALLOWED_ENGINES } from '../search/engine.js';
 import { batchFetch, fetchReadableDocument } from '../fetch/document.js';
 import { generateSummary, testConnection } from '../ai/orchestrator.js';
@@ -11,7 +14,17 @@ import { detectProfileTarget, scanProfile, PROFILER_PLATFORMS } from '../profile
 import { fetchBlueskyPosts, fetchBlueskyActors, fetchGdeltArticles } from '../social/search.js';
 import { scrapeTPB, scrape1337x, extractMagnetFromUrl } from '../torrent/scrapers.js';
 
-const APP_VERSION = '0.3.3';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const APP_VERSION = (() => {
+  try {
+    const pkgPath = path.join(__dirname, '../../package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    return String(pkg.version || '0.0.0');
+  } catch {
+    return '0.0.0';
+  }
+})();
 const ALLOWED_CATEGORIES = new Set(['web', 'images', 'news']);
 const ALLOWED_LANGS = new Set(['auto', 'it-IT', 'en-US', 'es-ES', 'fr-FR', 'de-DE', 'pt-PT', 'ru-RU', 'zh-CN', 'ja-JP']);
 
@@ -218,6 +231,23 @@ export function createRouter(config, rateLimiters) {
     });
   });
 
+  // ─── OpenSearch (dynamic — adapts to host/port) ─────────────────────────
+  router.get('/opensearch.xml', (req, res) => {
+    const proto = req.protocol;
+    const host = req.get('host') || `${req.hostname}:${req.socket.localPort}`;
+    const origin = `${proto}://${host}`;
+    res.setHeader('Content-Type', 'application/opensearchdescription+xml; charset=utf-8');
+    res.setHeader('Cache-Control', 'public, max-age=3600');
+    res.send(`<?xml version="1.0" encoding="UTF-8"?>
+<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
+  <ShortName>TermSearch</ShortName>
+  <Description>TermSearch — personal search engine</Description>
+  <InputEncoding>UTF-8</InputEncoding>
+  <Image height="64" width="64" type="image/svg+xml">${origin}/icon.svg</Image>
+  <Url type="text/html" method="get" template="${origin}/#/?q={searchTerms}"/>
+</OpenSearchDescription>`);
+  });
+
   // ─── OpenAPI ─────────────────────────────────────────────────────────────
   router.get('/api/openapi.json', (_req, res) => {
     applySecurityHeaders(res);

package/src/server.js

@@ -36,14 +36,27 @@ app.use(router);
 
 // Serve frontend static files
 app.use(express.static(FRONTEND_DIST, {
-  maxAge: '1h',
+  maxAge: 0,
   etag: true,
   index: 'index.html',
+  setHeaders: (res, filePath) => {
+    const base = path.basename(filePath);
+    if (base === 'index.html' || base === 'app.js' || base === 'style.css') {
+      res.setHeader('Cache-Control', 'no-store, no-cache, must-revalidate');
+      res.setHeader('Pragma', 'no-cache');
+      res.setHeader('Expires', '0');
+      return;
+    }
+    res.setHeader('Cache-Control', 'public, max-age=3600');
+  },
 }));
 
 // SPA fallback — serve index.html for any non-API route
 app.get('*', (req, res) => {
   applySecurityHeaders(res);
+  res.setHeader('Cache-Control', 'no-store, no-cache, must-revalidate');
+  res.setHeader('Pragma', 'no-cache');
+  res.setHeader('Expires', '0');
   res.sendFile(path.join(FRONTEND_DIST, 'index.html'));
 });
 

package/frontend/dist/opensearch.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
-  <ShortName>TermSearch</ShortName>
-  <Description>TermSearch — personal search engine</Description>
-  <InputEncoding>UTF-8</InputEncoding>
-  <Image height="64" width="64" type="image/svg+xml">/icon.svg</Image>
-  <Url type="text/html" method="get" template="http://localhost:3000/#/?q={searchTerms}"/>
-</OpenSearchDescription>