@maudecode/cove 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MaudeCode
+
+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,177 @@
+<p align="center">
+  <img src="./docs/banner.jpg" alt="Cove" width="640">
+</p>
+
+<p align="center">
+  A beautiful, full-featured WebUI for <a href="https://github.com/openclaw/openclaw">OpenClaw</a>
+</p>
+
+<p align="center">
+  <a href="#-features">Features</a> •
+  <a href="#-quick-start">Quick Start</a> •
+  <a href="#-deployment">Deployment</a> •
+  <a href="#-development">Development</a>
+</p>
+
+---
+
+## ✨ Features
+
+### 💬 Chat
+- **Real-time streaming** — Watch responses flow in with live markdown rendering
+- **Tool call visualization** — See what your assistant is doing with expandable tool details
+- **Syntax highlighting** — Beautiful code blocks with one-click copy
+- **File upload** — Drag & drop or paste images directly into chat
+- **Message search** — Find anything with text search and date filters
+- **Session management** — Create, rename, delete, and organize conversations
+
+### 🎛️ Operations Dashboard
+- **Cron Jobs** — Create and manage scheduled tasks with visual editors
+- **Config Editor** — Full configuration editing with schema validation and diff view
+- **Sessions Admin** — View all sessions with stats, filters, and bulk actions
+- **Channels** — Monitor all messaging channels (Telegram, Discord, Signal, etc.)
+- **Skills Browser** — Browse local and [ClawHub](https://clawhub.ai) skills, install with one click
+- **Devices** — Manage paired devices, approve pairing requests
+- **Logs** — Real-time log viewer with level filtering and search
+- **Debug** — RPC tester, event stream, connection diagnostics
+
+### 🎨 Customization
+- **6 themes** — Light, Dark, Nord, Dracula, Solarized Light/Dark
+- **System sync** — Automatically switches with your OS preference
+- **Font options** — System, Geist, Inter, JetBrains Mono, OpenDyslexic
+- **Adjustable sizing** — Small, medium, or large text
+
+### 🔒 Security
+- **Exec approval** — Interactive modal for shell command approvals
+- **Secure storage** — Credentials stored in browser localStorage
+- **No telemetry** — Your data stays on your gateway
+
+## 🚀 Quick Start
+
+### Option 1: Docker (Recommended)
+
+```bash
+docker run -d -p 8080:8080 ghcr.io/maudecode/cove:latest
+```
+
+Then open http://localhost:8080 and connect to your OpenClaw gateway.
+
+### Option 2: Static Hosting
+
+Download the latest release and serve the `dist/` folder with any static file server:
+
+```bash
+# Using Python
+cd dist && python -m http.server 8080
+
+# Using Node
+npx serve dist -p 8080
+
+# Using Caddy
+caddy file-server --root dist --listen :8080
+```
+
+### Option 3: Build from Source
+
+```bash
+git clone https://github.com/MaudeCode/cove.git
+cd cove
+bun install
+bun run build
+```
+
+The built files will be in `dist/`.
+
+## 📱 Connecting to Your Gateway
+
+1. Open Cove in your browser
+2. Enter your OpenClaw gateway URL (e.g., `wss://your-gateway.example.com`)
+3. Choose authentication method:
+   - **Token** — Use your gateway token
+   - **Password** — Use the configured password
+4. Click Connect
+
+**First time?** The onboarding wizard will guide you through setup.
+
+## 🏗️ Development
+
+```bash
+# Install dependencies
+bun install
+
+# Start dev server
+bun run dev
+
+# Run all checks (lint, format, typecheck, unused exports)
+bun run check
+
+# Build for production
+bun run build
+```
+
+### Project Structure
+
+```
+src/
+├── components/
+│   ├── ui/           # Reusable primitives (Button, Modal, Card, etc.)
+│   ├── chat/         # Chat interface components
+│   └── layout/       # App shell, sidebar, navigation
+├── views/            # Page components (ChatView, CronView, etc.)
+├── lib/              # Core utilities (gateway client, i18n, theme)
+├── signals/          # Preact Signals state management
+├── hooks/            # Custom Preact hooks
+├── types/            # TypeScript definitions
+└── locales/          # Translation files
+```
+
+### Tech Stack
+
+| Technology | Purpose |
+|------------|---------|
+| [Preact](https://preactjs.com/) | UI framework (~3KB) |
+| [Preact Signals](https://preactjs.com/guide/v10/signals/) | Reactive state |
+| [Tailwind CSS v4](https://tailwindcss.com/) | Styling |
+| [Vite](https://vitejs.dev/) | Build tooling |
+| [TypeScript](https://www.typescriptlang.org/) | Type safety |
+| [marked](https://marked.js.org/) | Markdown rendering |
+| [Prism](https://prismjs.com/) | Syntax highlighting |
+
+## 🤝 Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feat/amazing-feature`)
+3. Make your changes
+4. Run checks (`bun run check`)
+5. Commit with conventional commits (`feat:`, `fix:`, `docs:`, etc.)
+6. Open a Pull Request
+
+See [ROADMAP.md](./ROADMAP.md) for planned features and areas needing help.
+
+## 📋 Requirements
+
+- **OpenClaw gateway** v0.9+ running and accessible
+- **Modern browser** with WebSocket support (Chrome, Firefox, Safari, Edge)
+
+## 🐛 Known Limitations
+
+- File uploads are image-only (PDF, text files coming soon)
+- Multi-tab sync for user messages requires page refresh
+- Assistant-generated images display as file paths (gateway enhancement planned)
+
+## 📄 License
+
+MIT — see [LICENSE](./LICENSE) for details.
+
+## 🔗 Links
+
+- [OpenClaw Documentation](https://docs.openclaw.ai)
+- [OpenClaw GitHub](https://github.com/openclaw/openclaw)
+- [ClawHub Skills](https://clawhub.ai)
+- [Discord Community](https://discord.com/invite/clawd)
+
+---
+
+Built with 🐄 by [Maude](https://github.com/MaudeCode) and [Kilian](https://github.com/kiliantyler)

package/bin/cove.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+
+import { createServer } from "node:http";
+import { readFile, stat } from "node:fs/promises";
+import { join, extname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { exec } from "node:child_process";
+
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const distDir = resolve(__dirname, "..", "dist");
+
+// Get version from package.json
+const packageJson = JSON.parse(
+  await readFile(resolve(__dirname, "..", "package.json"), "utf-8")
+);
+const version = packageJson.version;
+
+// Parse CLI arguments
+const args = process.argv.slice(2);
+let port = 8080;
+let open = false;
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === "--port" || args[i] === "-p") {
+    port = parseInt(args[i + 1], 10) || 8080;
+    i++;
+  } else if (args[i] === "--open" || args[i] === "-o") {
+    open = true;
+  } else if (args[i] === "--version" || args[i] === "-v") {
+    console.log(`cove v${version}`);
+    process.exit(0);
+  } else if (args[i] === "--help" || args[i] === "-h") {
+    console.log(`
+Cove v${version} - WebUI for OpenClaw
+
+Usage: npx @maudecode/cove [options]
+
+Options:
+  -p, --port <port>  Port to listen on (default: 8080)
+  -o, --open         Open browser automatically
+  -v, --version      Show version number
+  -h, --help         Show this help message
+
+Examples:
+  npx @maudecode/cove
+  npx @maudecode/cove --port 3000
+  npx @maudecode/cove --port 3000 --open
+`);
+    process.exit(0);
+  }
+}
+
+// MIME types
+const mimeTypes = {
+  ".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",
+  ".ico": "image/x-icon",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2",
+  ".ttf": "font/ttf",
+  ".txt": "text/plain",
+};
+
+/**
+ * Check if a path is within the allowed directory (prevent path traversal)
+ */
+function isPathSafe(requestedPath, baseDir) {
+  const fullPath = resolve(requestedPath);
+  // Ensure resolved path starts with baseDir
+  return fullPath === baseDir || fullPath.startsWith(baseDir + "/");
+}
+
+// Serve static files
+const server = createServer(async (req, res) => {
+  try {
+    let urlPath = req.url?.split("?")[0] || "/";
+    if (urlPath === "/") urlPath = "/index.html";
+
+    // Health check endpoint
+    if (urlPath === "/health") {
+      res.writeHead(200, { "Content-Type": "text/plain" });
+      res.end("OK");
+      return;
+    }
+
+    // Decode URL and resolve path
+    const decodedPath = decodeURIComponent(urlPath);
+    let filePath = resolve(distDir, "." + decodedPath);
+
+    // Security: Ensure path doesn't escape dist directory
+    if (!isPathSafe(filePath, distDir)) {
+      res.writeHead(403);
+      res.end("Forbidden");
+      return;
+    }
+
+    // Check if file exists, otherwise serve index.html (SPA routing)
+    try {
+      const fileStat = await stat(filePath);
+      if (fileStat.isDirectory()) {
+        filePath = join(filePath, "index.html");
+      }
+    } catch {
+      filePath = join(distDir, "index.html");
+    }
+
+    const ext = extname(filePath);
+    const contentType = mimeTypes[ext] || "application/octet-stream";
+    const content = await readFile(filePath);
+
+    res.writeHead(200, { "Content-Type": contentType });
+    res.end(content);
+  } catch (err) {
+    res.writeHead(500);
+    res.end("Internal Server Error");
+  }
+});
+
+// Handle server errors
+server.on("error", (err) => {
+  if (err.code === "EADDRINUSE") {
+    console.error(`\n❌ Port ${port} is already in use.\n`);
+    console.error(`   Try a different port: npx @maudecode/cove --port ${port + 1}\n`);
+    process.exit(1);
+  }
+  console.error("Server error:", err);
+  process.exit(1);
+});
+
+server.listen(port, () => {
+  const url = `http://localhost:${port}`;
+  console.log(`
+🏖️  Cove v${version} is running!
+
+   Local:  ${url}
+
+   Connect to your OpenClaw gateway to get started.
+   Press Ctrl+C to stop.
+`);
+
+  if (open) {
+    const cmd =
+      process.platform === "darwin"
+        ? "open"
+        : process.platform === "win32"
+          ? "start"
+          : "xdg-open";
+    exec(`${cmd} ${url}`);
+  }
+});