otherwise-cli 0.1.0

package/README.md

@@ -0,0 +1,193 @@
+# Otherwise CLI
+
+Your personal AI assistant that lives on your computer.
+
+## Installation
+
+**From npm (recommended)**
+
+```bash
+npm install -g otherwise-cli
+otherwise
+```
+
+**From source**
+
+```bash
+cd cli
+npm install
+npm run build:frontend   # build web UI (required before first run)
+npm link                # makes 'otherwise' available globally
+```
+
+## Usage
+
+### Start the server
+
+```bash
+otherwise              # Start server + Ink terminal UI
+otherwise --verbose    # Start server, no Ink UI — raw logs in terminal, chat in browser
+otherwise -server-only # Start server only (no CLI, no logs)
+otherwise -port 8080   # Use different port
+```
+
+### Configure API keys
+
+```bash
+otherwise config                    # Show current config
+otherwise config set anthropic sk-... # Set Anthropic API key
+otherwise config set openai sk-...    # Set OpenAI API key
+otherwise config set google ...       # Set Google API key
+otherwise config set xai ...          # Set xAI API key
+otherwise config set model gpt-4o     # Change default model
+```
+
+### Deploy publicly
+
+```bash
+otherwise deploy -quick    # Quick tunnel (temporary URL)
+otherwise deploy           # Named tunnel (custom domain)
+```
+
+### Connect to otherwise.ai (remote)
+
+Link this CLI to your otherwise.ai account so the web app routes chat to this machine:
+
+```bash
+otherwise connect        # Device code flow: enter short code at otherwise.ai/connect
+otherwise connect <token> # Or paste a pairing token from Settings → Connect your CLI
+```
+
+**Chat persistence:** When the frontend is connected to the backend (otherwise.ai), chat list and history are read from Supabase. For new chats created on this CLI to appear in the cloud and survive refresh, set Supabase env vars on the machine running the CLI:
+
+- `SUPABASE_URL` – your project URL
+- `SUPABASE_SERVICE_KEY` – service role key (backend only)
+
+If these are not set, the CLI will log: _"Frontend sent accessToken but Supabase is not configured..."_ and new chats will only exist locally (they disappear from the web app on refresh).
+
+## Features
+
+- **Local AI Server** - Runs on your computer with access to your filesystem
+- **Multiple Providers** - Claude, GPT, Gemini, Grok, Ollama
+- **Agent Tools** - File read/write, shell commands, web search
+- **Email Integration** - IMAP/SMTP for reading and sending email
+- **Scheduled Tasks** - Cron-based task scheduling
+- **Public Access** - Cloudflare Tunnel for custom domain hosting
+
+## Project Structure
+
+```
+cli/
+├── bin/otherwise.js      # CLI entry point
+├── src/
+│   ├── index.js          # Commander CLI
+│   ├── server.js         # Fastify server
+│   ├── config.js         # Configuration store
+│   ├── inference/        # LLM providers
+│   ├── agent/            # Agent loop & tools
+│   ├── storage/          # SQLite database
+│   ├── scheduler/        # Cron tasks
+│   ├── email/            # IMAP/SMTP
+│   └── tunnel/           # Cloudflare
+└── frontend/             # Built React app (after build)
+```
+
+## Development
+
+```bash
+# Build frontend and copy to CLI
+npm run build:frontend
+
+# Run in development mode
+npm run dev
+```
+
+## Configuration
+
+Config is stored at `~/.otherwise/config.json`:
+
+```json
+{
+  "apiKeys": {
+    "anthropic": "sk-...",
+    "openai": "sk-...",
+    "google": "...",
+    "xai": "..."
+  },
+  "model": "claude-sonnet-4-20250514",
+  "permissions": {
+    "fileRead": ["~/*"],
+    "fileWrite": ["~/ai-workspace/*"],
+    "shell": true,
+    "email": true
+  }
+}
+```
+
+## Agent Tools
+
+The AI can use these tools during conversations:
+
+| Tool                   | Description               |
+| ---------------------- | ------------------------- |
+| `read_file`            | Read file contents        |
+| `write_file`           | Create or update files    |
+| `list_directory`       | List files in a directory |
+| `search_files`         | Search for files by name  |
+| `execute_command`      | Run shell commands        |
+| `web_search`           | Search the web            |
+| `fetch_url`            | Fetch content from a URL  |
+| `check_email`          | Check inbox (IMAP)        |
+| `send_email`           | Send email (SMTP)         |
+| `schedule_task`        | Create a scheduled task   |
+| `list_scheduled_tasks` | View scheduled tasks      |
+| `cancel_task`          | Cancel a scheduled task   |
+
+### Debugging web search
+
+When an engine returns 0 results, the CLI logs pattern counts and **the first 2,500 characters of the response HTML** so you can see what was actually returned. Run with **verbose** to see these logs:
+
+```bash
+otherwise -verbose
+```
+
+To write the **full HTML** for failed engines to a temp file (e.g. `otherwise-websearch-google-1234567890.html`), set:
+
+```bash
+WEBSEARCH_DEBUG=1 otherwise -verbose
+```
+
+Google and Bing requests use crawler User-Agents (AdsBot-Google and bingbot) to reduce bot detection and improve the chance of receiving static SERP HTML instead of captchas or JS-only pages.
+
+When an engine returns **0 results**, the CLI automatically retries that engine using a **headless browser** (Playwright) so JavaScript-rendered or bot-blocked pages (e.g. Google, Ecosia/Cloudflare) can be parsed. To disable this fallback (e.g. to avoid launching Chromium), set:
+
+```bash
+WEBSEARCH_USE_BROWSER=0 otherwise -verbose
+```
+
+### Proxy for Google and Bing
+
+To reduce captcha/blocking from Google and Bing, you can route **all web search traffic** (initial fetch and browser retry) through a proxy:
+
+```bash
+# HTTP/HTTPS proxy (used for every search engine request and headless browser)
+export WEBSEARCH_PROXY=http://proxy.example.com:8080
+# Or use standard env vars (same behavior)
+export HTTPS_PROXY=http://proxy.example.com:8080
+# With auth:
+export WEBSEARCH_PROXY=http://user:pass@proxy.example.com:8080
+otherwise -verbose
+```
+
+Only **web search** requests use this proxy; other tools (e.g. `fetch_url`, API calls) are unchanged.
+
+### SerpAPI (optional) for Google and Bing
+
+For reliable Google and Bing results without captcha or scraping, set **SerpAPI** (free tier: 100 searches/month):
+
+```bash
+export SERPAPI_API_KEY=your_serpapi_key
+otherwise
+```
+
+When `SERPAPI_API_KEY` is set, Google and Bing use SerpAPI’s JSON API instead of scraping. Other engines (Brave, DuckDuckGo, Startpage, Yahoo, Ecosia) still use direct fetch/browser. Get a key at [serpapi.com](https://serpapi.com/).

package/bin/otherwise.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { run } from '../src/index.js';
+
+run();

package/frontend/404.html

@@ -0,0 +1,84 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>404 - Page Not Found | Otherwise</title>
+    <meta name="robots" content="noindex, follow" />
+    <meta
+      name="description"
+      content="The page you're looking for doesn't exist. Return to Otherwise homepage."
+    />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <link rel="alternate icon" href="/favicon.ico" />
+
+    <style media="screen">
+      body {
+        background: #111827;
+        color: #e5e7eb;
+        font-family:
+          ui-sans-serif,
+          system-ui,
+          -apple-system,
+          BlinkMacSystemFont,
+          'Segoe UI',
+          Roboto,
+          'Helvetica Neue',
+          Arial,
+          'Noto Sans',
+          sans-serif,
+          'Apple Color Emoji',
+          'Segoe UI Emoji',
+          'Segoe UI Symbol',
+          'Noto Color Emoji';
+        margin: 0;
+        padding: 0;
+        display: flex;
+        flex-direction: column;
+        justify-content: center;
+        align-items: center;
+        height: 100vh;
+        text-align: center;
+      }
+      pre {
+        font-family:
+          ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,
+          'Liberation Mono', 'Courier New', monospace;
+        font-size: 0.875rem;
+        line-height: 1.25rem;
+        white-space: pre;
+      }
+      h1 {
+        font-size: 1.875rem; /* 30px */
+        line-height: 2.25rem; /* 36px */
+        font-weight: 600;
+        margin-top: 2rem;
+        margin-bottom: 1rem;
+      }
+      h2 {
+        font-size: 1.125rem; /* 18px */
+        line-height: 1.75rem; /* 28px */
+        font-weight: 400;
+        margin-bottom: 2rem;
+      }
+      a {
+        display: inline-block;
+        background: #4f46e5;
+        color: white;
+        padding: 0.75rem 1.5rem;
+        border-radius: 0.5rem;
+        text-decoration: none;
+        font-weight: 600;
+        transition: background-color 0.2s;
+      }
+      a:hover {
+        background: #4338ca;
+      }
+    </style>
+  </head>
+  <body>
+    <h1>404 - Page Not Found</h1>
+    <h2>Looks like you're lost in the digital wilderness.</h2>
+    <a href="/">Go back home</a>
+  </body>
+</html>

package/frontend/assets/__vite-browser-external-BIHI7g3E.js

@@ -0,0 +1 @@
+const e={};export{e as default};