openclaw-cortex 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ivan Honer
+
+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,67 @@
+# openclaw-cortex
+
+**Cyberpunk web UI for [OpenClaw](https://openclaw.com)** — chat, admin dashboard, node fleet management.
+
+## Quick Start
+
+```bash
+# Run directly (no install needed)
+npx openclaw-cortex --gateway https://your-openclaw-gateway.com
+
+# Or install globally
+npm install -g openclaw-cortex
+cortex-ui --gateway https://your-openclaw-gateway.com --open
+```
+
+## Options
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `-g, --gateway <url>` | *(prompted)* | OpenClaw gateway URL |
+| `-p, --port <port>` | `8480` | Port to serve on |
+| `--host <host>` | `0.0.0.0` | Host to bind to |
+| `--title <title>` | `Cortex` | App title |
+| `-o, --open` | `false` | Open browser after starting |
+| `-h, --help` | | Show help |
+
+## Gateway Setup
+
+Make sure your OpenClaw gateway allows connections from Cortex:
+
+```bash
+openclaw config set controlUi.allowedOrigins '["http://localhost:8480"]'
+```
+
+## Authentication
+
+- **Device Pairing** — Enter gateway URL, device auto-pairs, gateway owner approves
+- **Token Auth** — Click "I have an access token" and paste your gateway token
+
+## Features
+
+- 💬 Real-time chat with streaming, thinking blocks, tool call visualization
+- 📊 16 admin pages (sessions, nodes, cron, config, memory, logs, etc.)
+- 🎨 Cyberpunk dark theme with customizable accent colors
+- 🔐 Ed25519 device identity authentication
+- 📱 PWA support (installable)
+- ⌨️ Keyboard shortcuts
+- 🖼️ Image upload & rendering
+- 🔔 Browser notifications
+
+## Docker Alternative
+
+If you prefer Docker:
+
+```bash
+curl -fsSL https://gitlab.honercloud.com/llm/cortex/-/raw/main/install.sh | bash
+```
+
+## Links
+
+- [Source Code](https://gitlab.honercloud.com/llm/cortex)
+- [OpenClaw](https://openclaw.com)
+- [Documentation](https://docs.openclaw.ai)
+
+## License
+
+MIT

package/bin/cortex-ui.mjs

@@ -0,0 +1,307 @@
+#!/usr/bin/env node
+// ═══════════════════════════════════════════════════════════
+//  Cortex UI — Lightweight static server for OpenClaw Web UI
+//
+//  Usage:
+//    npx cortex-ui --gateway https://my-openclaw.com
+//    cortex-ui start --port 8480 --gateway https://my-openclaw.com
+//    cortex-ui --help
+// ═══════════════════════════════════════════════════════════
+
+import { createServer } from 'node:http';
+import { readFileSync, existsSync, statSync } from 'node:fs';
+import { join, extname, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { writeFileSync } from 'node:fs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const STATIC_DIR = join(__dirname, '..', 'static');
+
+// ─── MIME types ────────────────────────────────────────
+
+const MIME_TYPES = {
+  '.html': 'text/html; charset=utf-8',
+  '.css': 'text/css; charset=utf-8',
+  '.js': 'application/javascript; charset=utf-8',
+  '.mjs': 'application/javascript; charset=utf-8',
+  '.json': 'application/json; charset=utf-8',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.gif': 'image/gif',
+  '.svg': 'image/svg+xml',
+  '.ico': 'image/x-icon',
+  '.webp': 'image/webp',
+  '.woff': 'font/woff',
+  '.woff2': 'font/woff2',
+  '.ttf': 'font/ttf',
+  '.eot': 'application/vnd.ms-fontobject',
+  '.webmanifest': 'application/manifest+json',
+  '.txt': 'text/plain; charset=utf-8',
+  '.xml': 'application/xml',
+};
+
+// ─── Parse args ────────────────────────────────────────
+
+function parseArgs(argv) {
+  const args = {
+    port: 8480,
+    host: '0.0.0.0',
+    gateway: '',
+    gatewayWs: '',
+    title: 'Cortex',
+    subtitle: 'OpenClaw Command Center',
+    open: false,
+    help: false,
+    version: false,
+  };
+
+  for (let i = 2; i < argv.length; i++) {
+    const arg = argv[i];
+    switch (arg) {
+      case '--port': case '-p':
+        args.port = parseInt(argv[++i], 10) || 8480;
+        break;
+      case '--host':
+        args.host = argv[++i] || '0.0.0.0';
+        break;
+      case '--gateway': case '-g':
+        args.gateway = argv[++i] || '';
+        break;
+      case '--gateway-ws':
+        args.gatewayWs = argv[++i] || '';
+        break;
+      case '--title':
+        args.title = argv[++i] || 'Cortex';
+        break;
+      case '--subtitle':
+        args.subtitle = argv[++i] || '';
+        break;
+      case '--open': case '-o':
+        args.open = true;
+        break;
+      case '--help': case '-h':
+        args.help = true;
+        break;
+      case '--version': case '-v':
+        args.version = true;
+        break;
+      case 'start': case 'serve':
+        // Subcommand, just skip
+        break;
+      default:
+        if (!arg.startsWith('-')) break;
+        console.error(`Unknown option: ${arg}`);
+        process.exit(1);
+    }
+  }
+
+  return args;
+}
+
+// ─── Help ──────────────────────────────────────────────
+
+function printHelp() {
+  const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
+  console.log(`
+  \x1b[35m┌───────────────────────────────────┐
+  │   🧠 Cortex UI  v${pkg.version.padEnd(16)}│
+  │   OpenClaw Web Interface          │
+  └───────────────────────────────────┘\x1b[0m
+
+  \x1b[1mUsage:\x1b[0m
+    cortex-ui [start] [options]
+    npx cortex-ui --gateway https://my-openclaw.com
+
+  \x1b[1mOptions:\x1b[0m
+    -g, --gateway <url>   OpenClaw gateway URL (pre-fills connection dialog)
+    --gateway-ws <url>    WebSocket URL override (auto-derived if omitted)
+    -p, --port <port>     Port to serve on (default: 8480)
+    --host <host>         Host to bind to (default: 0.0.0.0)
+    --title <title>       App title (default: Cortex)
+    --subtitle <text>     Subtitle in auth dialog
+    -o, --open            Open browser after starting
+    -v, --version         Show version
+    -h, --help            Show this help
+
+  \x1b[1mExamples:\x1b[0m
+    cortex-ui --gateway https://openclaw.example.com
+    cortex-ui --port 3000 --gateway https://my-gateway.com --open
+    cortex-ui --gateway http://localhost:18789
+
+  \x1b[1mGateway setup:\x1b[0m
+    Add Cortex to your gateway's allowed origins:
+    openclaw config set controlUi.allowedOrigins '["http://localhost:8480"]'
+  `);
+}
+
+// ─── Generate config.json ──────────────────────────────
+
+function generateConfig(args) {
+  const config = {};
+
+  if (args.gateway) {
+    config.gatewayUrl = args.gateway;
+    // Auto-derive WebSocket URL
+    if (args.gatewayWs) {
+      config.gatewayWs = args.gatewayWs;
+    } else {
+      config.gatewayWs = args.gateway
+        .replace(/^https:\/\//, 'wss://')
+        .replace(/^http:\/\//, 'ws://');
+    }
+  }
+
+  if (args.title !== 'Cortex') config.title = args.title;
+  if (args.subtitle !== 'OpenClaw Command Center') config.subtitle = args.subtitle;
+
+  return JSON.stringify(config, null, 2);
+}
+
+// ─── Security headers ──────────────────────────────────
+
+function setSecurityHeaders(res) {
+  res.setHeader('X-Content-Type-Options', 'nosniff');
+  res.setHeader('X-Frame-Options', 'DENY');
+  res.setHeader('X-XSS-Protection', '0');
+  res.setHeader('Referrer-Policy', 'strict-origin-when-cross-origin');
+  res.setHeader('Permissions-Policy', 'camera=(), microphone=(), geolocation=()');
+}
+
+// ─── Serve ─────────────────────────────────────────────
+
+function startServer(args) {
+  const configJson = generateConfig(args);
+
+  const server = createServer((req, res) => {
+    let urlPath = new URL(req.url || '/', `http://${req.headers.host}`).pathname;
+
+    setSecurityHeaders(res);
+
+    // Health check
+    if (urlPath === '/health') {
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end('{"status":"ok","app":"cortex-ui","mode":"npm"}');
+      return;
+    }
+
+    // Serve generated config.json
+    if (urlPath === '/config.json') {
+      res.writeHead(200, {
+        'Content-Type': 'application/json',
+        'Cache-Control': 'no-cache, no-store, must-revalidate',
+      });
+      res.end(configJson);
+      return;
+    }
+
+    // Normalize path
+    if (urlPath === '/') urlPath = '/index.html';
+
+    // Try to serve static file
+    const filePath = join(STATIC_DIR, urlPath);
+
+    // Security: prevent directory traversal
+    if (!filePath.startsWith(STATIC_DIR)) {
+      res.writeHead(403);
+      res.end('Forbidden');
+      return;
+    }
+
+    if (existsSync(filePath) && statSync(filePath).isFile()) {
+      const ext = extname(filePath).toLowerCase();
+      const contentType = MIME_TYPES[ext] || 'application/octet-stream';
+      const content = readFileSync(filePath);
+
+      const headers = { 'Content-Type': contentType };
+
+      // Cache headers
+      if (urlPath === '/index.html') {
+        headers['Cache-Control'] = 'no-cache, no-store, must-revalidate';
+      } else if (ext === '.js' || ext === '.css' || ext === '.woff2') {
+        headers['Cache-Control'] = 'public, max-age=31536000, immutable';
+      }
+
+      res.writeHead(200, headers);
+      res.end(content);
+      return;
+    }
+
+    // SPA fallback — serve index.html for all routes
+    const indexPath = join(STATIC_DIR, 'index.html');
+    if (existsSync(indexPath)) {
+      const content = readFileSync(indexPath);
+      res.writeHead(200, {
+        'Content-Type': 'text/html; charset=utf-8',
+        'Cache-Control': 'no-cache, no-store, must-revalidate',
+      });
+      res.end(content);
+      return;
+    }
+
+    res.writeHead(404);
+    res.end('Not Found');
+  });
+
+  server.listen(args.port, args.host, () => {
+    const local = `http://localhost:${args.port}`;
+    const network = args.host === '0.0.0.0'
+      ? `http://<your-ip>:${args.port}`
+      : `http://${args.host}:${args.port}`;
+
+    console.log(`
+  \x1b[35m┌───────────────────────────────────┐
+  │   🧠 Cortex UI                    │
+  └───────────────────────────────────┘\x1b[0m
+
+  \x1b[32m✓\x1b[0m Server running
+
+  \x1b[1mLocal:\x1b[0m    \x1b[36m${local}\x1b[0m
+  \x1b[1mNetwork:\x1b[0m  \x1b[36m${network}\x1b[0m
+${args.gateway ? `  \x1b[1mGateway:\x1b[0m  \x1b[36m${args.gateway}\x1b[0m` : ''}
+
+  \x1b[2mPress Ctrl+C to stop\x1b[0m
+    `);
+
+    // Open browser if requested
+    if (args.open) {
+      import('node:child_process').then(({ exec }) => {
+        const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+        exec(`${cmd} ${local}`);
+      });
+    }
+  });
+
+  // Graceful shutdown
+  process.on('SIGINT', () => {
+    console.log('\n  Shutting down...');
+    server.close(() => process.exit(0));
+  });
+  process.on('SIGTERM', () => {
+    server.close(() => process.exit(0));
+  });
+}
+
+// ─── Main ──────────────────────────────────────────────
+
+const args = parseArgs(process.argv);
+
+if (args.version) {
+  const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
+  console.log(pkg.version);
+  process.exit(0);
+}
+
+if (args.help) {
+  printHelp();
+  process.exit(0);
+}
+
+// Verify static files exist
+if (!existsSync(join(STATIC_DIR, 'index.html'))) {
+  console.error('\x1b[31m✗\x1b[0m Static files not found. Package may be corrupted.');
+  console.error(`  Expected: ${STATIC_DIR}/index.html`);
+  process.exit(1);
+}
+
+startServer(args);

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "openclaw-cortex",
+  "version": "1.1.0",
+  "description": "Cyberpunk web UI for OpenClaw — chat, admin dashboard, node fleet management",
+  "keywords": [
+    "openclaw",
+    "ai",
+    "assistant",
+    "web-ui",
+    "dashboard",
+    "chat",
+    "admin",
+    "cyberpunk"
+  ],
+  "homepage": "https://gitlab.honercloud.com/llm/cortex",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.honercloud.com/llm/cortex.git"
+  },
+  "license": "MIT",
+  "author": "Ivan Honer",
+  "bin": {
+    "openclaw-cortex": "./bin/cortex-ui.mjs",
+    "cortex-ui": "./bin/cortex-ui.mjs"
+  },
+  "files": [
+    "bin/",
+    "static/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/static/_app/env.js

@@ -0,0 +1 @@
+export const env={}