opencami 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Julien Thibeaut (original WebClaw - github.com/ibelick/webclaw)
+Copyright (c) 2026 Robby (OpenCami additions - github.com/robbyczgw-cla/opencami)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# OpenCami 🦎
+
+> **Web chat client for [OpenClaw](https://github.com/openclaw/openclaw)** — AI chat interface with PWA support, smart titles, voice playback & more.
+
+Forked from [WebClaw](https://github.com/ibelick/webclaw).
+
+[![OpenCami](https://img.shields.io/badge/OpenCami-🦎-green)](https://opencami.xyz)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+![OpenCami Chat Interface](docs/screenshots/opencami-chat.jpg)
+
+## ✨ Features
+
+**Core:**
+💬 Multi-session chat · 🎨 Theme support · ⚙️ Settings dialog · 📝 Markdown rendering · 📱 Mobile-responsive
+
+**Communication:**
+⚡ Real-time streaming · 🔊 Voice playback (TTS)
+
+**Organization:**
+📁 Session folders · 🦎 OpenCami chat folder · 📌 Pin sessions · 🗑️ Bulk delete · 🛡️ Protected sessions
+
+**Search & Navigation:**
+🔍 Conversation search · ⌨️ Keyboard shortcuts · 📥 Export conversations
+
+**Customization:**
+🎨 Model selector · 🎭 Persona picker · 🦎 Chameleon theme · 🔤 Text size control
+
+**Files:**
+📂 File explorer · 🖼️ Image attachments
+
+**Smart Features:**
+🏷️ Smart titles · 💡 Smart follow-ups · 💬 Slash commands
+
+**Mobile:**
+👉 Swipe gestures · ⚡ Lazy loading · 📱 Native Android APK (Capacitor)
+
+**PWA:**
+📱 Install as app · 🔄 Offline support · 🚀 Auto-update
+
+→ **[See detailed feature descriptions in docs/features.md](docs/features.md)**
+
+## 🚀 Quick Start
+
+```bash
+# Clone
+git clone https://github.com/robbyczgw-cla/opencami.git
+cd opencami
+
+# Install
+npm install
+
+# Configure
+cp .env.example .env.local
+# Edit .env.local with your Gateway URL and token
+
+# Run
+npm run dev
+```
+
+Open http://localhost:3001
+
+## 📱 Install as PWA
+
+1. Open OpenCami in your browser
+2. **Android:** Tap ⋮ menu → "Install app" or "Add to Home Screen"
+3. **iOS:** Tap Share → "Add to Home Screen"
+
+## 📚 Documentation
+
+- **[Features](docs/features.md)** — Detailed feature descriptions
+- **[Architecture](docs/architecture.md)** — Technical overview
+- **[Deployment](docs/deployment.md)** — Self-hosting guide
+- **[Contributing](docs/contributing.md)** — Development workflow
+- **[Changelog](docs/changelog.md)** — Version history
+
+## 🔄 Upstream Contributions
+
+PRs submitted to [ibelick/webclaw](https://github.com/ibelick/webclaw):
+- ✅ [PR #1](https://github.com/ibelick/webclaw/pull/1) — Locale fix (MERGED)
+- ⏳ [PR #4](https://github.com/ibelick/webclaw/pull/4) — Image attachments
+- ⏳ [PR #9](https://github.com/ibelick/webclaw/pull/9) — Conversation search
+- ⏳ [PR #10](https://github.com/ibelick/webclaw/pull/10) — Conversation export
+- ⏳ [PR #11](https://github.com/ibelick/webclaw/pull/11) — Text size setting
+
+## 🗺️ Roadmap
+
+- [x] 🔊 Voice Playback (multi-provider TTS)
+- [x] 🎭 Persona Picker
+- [x] 🎨 Model Selector
+- [x] 📱 PWA Support
+- [x] ⚡ Real-Time Streaming
+- [x] 📂 File Explorer
+- [ ] 🔔 Push Notifications (PWA)
+- [ ] 🎤 Voice Input (Whisper transcription)
+- [ ] 📎 File Uploads (PDFs, docs, code)
+- [ ] 📊 Usage Dashboard
+
+## 🙏 Credits
+
+- **[WebClaw](https://github.com/ibelick/webclaw)** by [Julien Thibeaut](https://github.com/ibelick) — Original project
+- **[balin-ar](https://github.com/balin-ar)** — File Explorer with built-in text editor ([PR #2](https://github.com/ibelick/webclaw/pull/2))
+- **[OpenClaw](https://github.com/openclaw/openclaw)** — The gateway that powers it all
+
+## 📄 License
+
+MIT — See [LICENSE](LICENSE)
+
+---
+
+🌐 **[opencami.xyz](https://opencami.xyz)** · Built with 💚 by the OpenCami community

package/bin/opencami.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+
+import { createServer } from 'node:http';
+import { readFile, stat } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { exec } from 'node:child_process';
+
+const __dirname = fileURLToPath(new URL('..', import.meta.url));
+
+// Parse args
+const args = process.argv.slice(2);
+function getArg(name, def) {
+  const i = args.indexOf(`--${name}`);
+  if (i === -1) return def;
+  return args[i + 1] || def;
+}
+const port = parseInt(getArg('port', '3000'), 10);
+const host = getArg('host', '127.0.0.1');
+const gateway = getArg('gateway', 'ws://127.0.0.1:18789');
+const noOpen = args.includes('--no-open');
+
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(`
+  opencami - Web UI for OpenClaw
+
+  Usage: opencami [options]
+
+  Options:
+    --port <n>       Port to listen on (default: 3000)
+    --host <addr>    Host to bind to (default: 127.0.0.1)
+    --gateway <url>  OpenClaw gateway URL (default: ws://127.0.0.1:18789)
+    --no-open        Don't open browser on start
+    -h, --help       Show this help
+`);
+  process.exit(0);
+}
+
+// Set gateway env for the app
+process.env.OPENCLAW_GATEWAY = gateway;
+
+const MIME_TYPES = {
+  '.html': 'text/html',
+  '.js': 'application/javascript',
+  '.css': 'text/css',
+  '.json': 'application/json',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.gif': 'image/gif',
+  '.svg': 'image/svg+xml',
+  '.webp': 'image/webp',
+  '.ico': 'image/x-icon',
+  '.woff': 'font/woff',
+  '.woff2': 'font/woff2',
+  '.ttf': 'font/ttf',
+  '.txt': 'text/plain',
+  '.webmanifest': 'application/manifest+json',
+};
+
+const clientDir = join(__dirname, 'dist', 'client');
+
+async function serveStatic(pathname) {
+  const filePath = join(clientDir, pathname);
+  // Prevent path traversal
+  if (!filePath.startsWith(clientDir)) return null;
+  try {
+    const s = await stat(filePath);
+    if (!s.isFile()) return null;
+    const data = await readFile(filePath);
+    const ext = extname(filePath);
+    return { data, mime: MIME_TYPES[ext] || 'application/octet-stream' };
+  } catch {
+    return null;
+  }
+}
+
+// Import the TanStack Start server
+const { default: server } = await import(join(__dirname, 'dist', 'server', 'server.js'));
+
+const httpServer = createServer(async (req, res) => {
+  const url = new URL(req.url, `http://${req.headers.host}`);
+
+  // Try static files first
+  const staticFile = await serveStatic(url.pathname);
+  if (staticFile) {
+    res.writeHead(200, { 'Content-Type': staticFile.mime, 'Cache-Control': 'public, max-age=31536000, immutable' });
+    res.end(staticFile.data);
+    return;
+  }
+
+  // Forward to SSR handler
+  try {
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(req.headers)) {
+      if (value) headers.set(key, Array.isArray(value) ? value.join(', ') : value);
+    }
+
+    const body = req.method !== 'GET' && req.method !== 'HEAD'
+      ? await new Promise((resolve, reject) => {
+          const chunks = [];
+          req.on('data', c => chunks.push(c));
+          req.on('end', () => resolve(Buffer.concat(chunks)));
+          req.on('error', reject);
+        })
+      : undefined;
+
+    const request = new Request(url.href, {
+      method: req.method,
+      headers,
+      body,
+      duplex: 'half',
+    });
+
+    const response = await server.fetch(request);
+
+    res.writeHead(response.status, Object.fromEntries(response.headers.entries()));
+
+    if (response.body) {
+      const reader = response.body.getReader();
+      const pump = async () => {
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) { res.end(); break; }
+          res.write(value);
+        }
+      };
+      pump().catch(() => res.end());
+    } else {
+      const buf = await response.arrayBuffer();
+      res.end(Buffer.from(buf));
+    }
+  } catch (err) {
+    console.error('Request error:', err.message);
+    if (!res.headersSent) {
+      res.writeHead(500, { 'Content-Type': 'text/plain' });
+      res.end('Internal Server Error');
+    }
+  }
+});
+
+httpServer.listen(port, host, () => {
+  const url = `http://${host === '0.0.0.0' ? 'localhost' : host}:${port}`;
+  console.log();
+  console.log('  🐾 \x1b[1mOpenCami\x1b[0m');
+  console.log();
+  console.log(`  ➜  Local:   \x1b[36m${url}\x1b[0m`);
+  console.log(`  ➜  Gateway: \x1b[33m${gateway}\x1b[0m`);
+  console.log();
+
+  if (!noOpen) {
+    const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+    exec(`${cmd} ${url}`, () => {});
+  }
+});