upfynai-code 0.1.0 → 2.2.0

package/client/dist/icons/icon-152x152.svg

@@ -0,0 +1,12 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background fills entire canvas - iOS will handle corner rounding -->
+  <rect width="512" height="512" fill="hsl(240 5.9% 10%)"/>
+  
+  <!-- MessageSquare icon - scaled and centered -->
+  <path d="M128 144C128 126.327 142.327 112 160 112H352C369.673 112 384 126.327 384 144V272C384 289.673 369.673 304 352 304H224L128 400V144Z" 
+        stroke="white" 
+        stroke-width="32" 
+        stroke-linecap="round" 
+        stroke-linejoin="round" 
+        fill="none"/>
+</svg>

package/client/dist/icons/icon-192x192.svg

@@ -0,0 +1,12 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background fills entire canvas - iOS will handle corner rounding -->
+  <rect width="512" height="512" fill="hsl(240 5.9% 10%)"/>
+  
+  <!-- MessageSquare icon - scaled and centered -->
+  <path d="M128 144C128 126.327 142.327 112 160 112H352C369.673 112 384 126.327 384 144V272C384 289.673 369.673 304 352 304H224L128 400V144Z" 
+        stroke="white" 
+        stroke-width="32" 
+        stroke-linecap="round" 
+        stroke-linejoin="round" 
+        fill="none"/>
+</svg>

package/client/dist/icons/icon-384x384.svg

@@ -0,0 +1,12 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background fills entire canvas - iOS will handle corner rounding -->
+  <rect width="512" height="512" fill="hsl(240 5.9% 10%)"/>
+  
+  <!-- MessageSquare icon - scaled and centered -->
+  <path d="M128 144C128 126.327 142.327 112 160 112H352C369.673 112 384 126.327 384 144V272C384 289.673 369.673 304 352 304H224L128 400V144Z" 
+        stroke="white" 
+        stroke-width="32" 
+        stroke-linecap="round" 
+        stroke-linejoin="round" 
+        fill="none"/>
+</svg>

package/client/dist/icons/icon-512x512.svg

@@ -0,0 +1,12 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background fills entire canvas - iOS will handle corner rounding -->
+  <rect width="512" height="512" fill="hsl(240 5.9% 10%)"/>
+  
+  <!-- MessageSquare icon - scaled and centered -->
+  <path d="M128 144C128 126.327 142.327 112 160 112H352C369.673 112 384 126.327 384 144V272C384 289.673 369.673 304 352 304H224L128 400V144Z" 
+        stroke="white" 
+        stroke-width="32" 
+        stroke-linecap="round" 
+        stroke-linejoin="round" 
+        fill="none"/>
+</svg>

package/client/dist/icons/icon-72x72.svg

@@ -0,0 +1,12 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background fills entire canvas - iOS will handle corner rounding -->
+  <rect width="512" height="512" fill="hsl(240 5.9% 10%)"/>
+  
+  <!-- MessageSquare icon - scaled and centered -->
+  <path d="M128 144C128 126.327 142.327 112 160 112H352C369.673 112 384 126.327 384 144V272C384 289.673 369.673 304 352 304H224L128 400V144Z" 
+        stroke="white" 
+        stroke-width="32" 
+        stroke-linecap="round" 
+        stroke-linejoin="round" 
+        fill="none"/>
+</svg>

package/client/dist/icons/icon-96x96.svg

@@ -0,0 +1,12 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background fills entire canvas - iOS will handle corner rounding -->
+  <rect width="512" height="512" fill="hsl(240 5.9% 10%)"/>
+  
+  <!-- MessageSquare icon - scaled and centered -->
+  <path d="M128 144C128 126.327 142.327 112 160 112H352C369.673 112 384 126.327 384 144V272C384 289.673 369.673 304 352 304H224L128 400V144Z" 
+        stroke="white" 
+        stroke-width="32" 
+        stroke-linecap="round" 
+        stroke-linejoin="round" 
+        fill="none"/>
+</svg>

package/client/dist/icons/icon-template.svg

@@ -0,0 +1,12 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background fills entire canvas - iOS will handle corner rounding -->
+  <rect width="512" height="512" fill="hsl(240 5.9% 10%)"/>
+  
+  <!-- MessageSquare icon - scaled and centered -->
+  <path d="M128 144C128 126.327 142.327 112 160 112H352C369.673 112 384 126.327 384 144V272C384 289.673 369.673 304 352 304H224L128 400V144Z" 
+        stroke="white" 
+        stroke-width="32" 
+        stroke-linecap="round" 
+        stroke-linejoin="round" 
+        fill="none"/>
+</svg>

package/client/dist/index.html

@@ -0,0 +1,128 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <link rel="icon" type="image/png" href="/favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0, user-scalable=no, viewport-fit=cover" />
+    <title>Upfyn-Code</title>
+    
+    <!-- PWA Manifest -->
+    <link rel="manifest" href="/manifest.json" />
+    
+    <!-- iOS Safari PWA Meta Tags -->
+    <meta name="mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
+    <meta name="apple-mobile-web-app-title" content="Upfyn-Code" />
+    
+    <!-- iOS Safari Icons -->
+    <link rel="apple-touch-icon" sizes="152x152" href="/icons/icon-152x152.png" />
+    <link rel="apple-touch-icon" sizes="180x180" href="/icons/icon-192x192.png" />
+    
+    <!-- Theme Color -->
+    <meta name="theme-color" content="#0a0f1e" />
+    <meta name="msapplication-TileColor" content="#0a0f1e" />
+
+    <!-- Prevent zoom on iOS -->
+    <meta name="format-detection" content="telephone=no" />
+
+    <!-- Inline critical styles for instant splash screen (before any JS loads) -->
+    <style>
+      body { margin: 0; background: #0a0f1e; }
+      #splash {
+        min-height: 100vh;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+        color: #e2e8f0;
+        flex-direction: column;
+        gap: 16px;
+      }
+      #splash .logo-box {
+        width: 64px; height: 64px;
+        background: linear-gradient(135deg, #3b82f6, #6366f1);
+        border-radius: 16px;
+        display: flex; align-items: center; justify-content: center;
+        box-shadow: 0 4px 24px rgba(99,102,241,0.3);
+      }
+      #splash .logo-box svg { width: 32px; height: 32px; color: #fff; }
+      #splash h1 { font-size: 1.5rem; font-weight: 700; margin: 0; }
+      #splash .dots { display: flex; gap: 6px; }
+      #splash .dots span {
+        width: 8px; height: 8px; border-radius: 50%;
+        background: #3b82f6;
+        animation: bounce 1s infinite;
+      }
+      #splash .dots span:nth-child(2) { animation-delay: 0.1s; }
+      #splash .dots span:nth-child(3) { animation-delay: 0.2s; }
+      @keyframes bounce {
+        0%, 80%, 100% { transform: translateY(0); }
+        40% { transform: translateY(-8px); }
+      }
+    </style>
+    <script type="module" crossorigin src="/assets/index-BPwf8Fw3.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/vendor-react-CHoMc7ka.js">
+    <link rel="modulepreload" crossorigin href="/assets/vendor-markdown-CIVH08vJ.js">
+    <link rel="modulepreload" crossorigin href="/assets/vendor-syntax-Djb62v3a.js">
+    <link rel="modulepreload" crossorigin href="/assets/vendor-icons-D33IkSIf.js">
+    <link rel="modulepreload" crossorigin href="/assets/vendor-i18n-ByAl-gdx.js">
+    <link rel="stylesheet" crossorigin href="/assets/index-B8wwD_Xo.css">
+  </head>
+  <body>
+    <!-- Static splash screen: visible INSTANTLY (pure HTML, no JS needed) -->
+    <!-- React replaces this entire div when it mounts -->
+    <div id="root">
+      <div id="splash">
+        <div class="logo-box">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+            <path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"></path>
+          </svg>
+        </div>
+        <h1>Upfyn-Code</h1>
+        <div class="dots">
+          <span></span><span></span><span></span>
+        </div>
+      </div>
+    </div>
+
+
+    <!-- Error detection: catch JS errors and show them instead of infinite loading -->
+    <script>
+      window.__REACT_MOUNTED = false;
+      window.addEventListener('error', function(e) {
+        if (window.__REACT_MOUNTED) return;
+        var s = document.getElementById('splash');
+        if (s) s.innerHTML = '<h1 style="margin:0">Upfyn-Code</h1><p style="color:#f87171">Failed to load: ' + (e.message || 'Unknown error') + '</p><button onclick="location.reload()" style="padding:10px 24px;border-radius:8px;border:none;background:#3b82f6;color:#fff;cursor:pointer;font-size:14px">Refresh</button>';
+      });
+      // Timeout: if React hasn't mounted in 20 seconds, show retry
+      setTimeout(function() {
+        if (window.__REACT_MOUNTED) return;
+        var s = document.getElementById('splash');
+        if (s && !s.querySelector('button')) {
+          var p = document.createElement('p');
+          p.style.cssText = 'color:#94a3b8;font-size:13px;margin:0';
+          p.innerHTML = 'Taking longer than expected. <a href="javascript:location.reload()" style="color:#3b82f6;text-decoration:underline">Refresh</a>';
+          s.appendChild(p);
+        }
+      }, 20000);
+    </script>
+
+    <!-- Service Worker cleanup -->
+    <script>
+      if ('serviceWorker' in navigator) {
+        navigator.serviceWorker.getRegistrations().then(function(regs) {
+          regs.forEach(function(r) { r.unregister(); });
+        });
+        if (window.caches) {
+          caches.keys().then(function(names) {
+            names.forEach(function(n) { caches.delete(n); });
+          });
+        }
+        window.addEventListener('load', function() {
+          navigator.serviceWorker.register('/sw.js').catch(function() {});
+        });
+      }
+    </script>
+  </body>
+</html>

package/client/dist/logo.svg

@@ -0,0 +1,17 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="32"
+  height="32"
+  viewBox="0 0 32 32"
+  fill="none"
+>
+  <rect width="32" height="32" rx="8" fill="hsl(221.2 83.2% 53.3%)"/>
+  <path
+    d="M8 9C8 8.44772 8.44772 8 9 8H23C23.5523 8 24 8.44772 24 9V18C24 18.5523 23.5523 19 23 19H12L8 23V9Z"
+    stroke="white"
+    strokeWidth="2"
+    strokeLinecap="round"
+    strokeLinejoin="round"
+    fill="none"
+  />
+</svg>

package/client/dist/manifest.json

@@ -0,0 +1,61 @@
+{
+  "name": "Upfyn-Code",
+  "short_name": "Upfyn-Code",
+  "description": "Upfyn-Code — Visual AI Coding Interface",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#ffffff",
+  "theme_color": "#ffffff",
+  "orientation": "portrait-primary",
+  "scope": "/",
+  "icons": [
+    {
+      "src": "/icons/icon-72x72.png",
+      "sizes": "72x72",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-96x96.png",
+      "sizes": "96x96",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-128x128.png",
+      "sizes": "128x128",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-144x144.png",
+      "sizes": "144x144",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-152x152.png",
+      "sizes": "152x152",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-384x384.png",
+      "sizes": "384x384",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "maskable any"
+    }
+  ]
+}

package/client/dist/mcp-docs.html

@@ -0,0 +1,119 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Upfyn-Code MCP Integration</title>
+  <style>
+    :root { --bg: #0d1117; --fg: #c9d1d9; --accent: #58a6ff; --card: #161b22; --border: #30363d; --code-bg: #1c2128; }
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif; background: var(--bg); color: var(--fg); line-height: 1.6; padding: 2rem; max-width: 800px; margin: 0 auto; }
+    h1 { color: #fff; margin-bottom: 0.5rem; font-size: 2rem; }
+    h2 { color: var(--accent); margin: 2rem 0 1rem; font-size: 1.4rem; border-bottom: 1px solid var(--border); padding-bottom: 0.5rem; }
+    h3 { color: #fff; margin: 1.5rem 0 0.5rem; }
+    p { margin-bottom: 1rem; }
+    a { color: var(--accent); }
+    .subtitle { color: #8b949e; margin-bottom: 2rem; }
+    pre { background: var(--code-bg); border: 1px solid var(--border); border-radius: 6px; padding: 1rem; overflow-x: auto; margin: 1rem 0; font-size: 0.9rem; }
+    code { font-family: 'SF Mono', 'Fira Code', monospace; color: #e6edf3; }
+    .card { background: var(--card); border: 1px solid var(--border); border-radius: 8px; padding: 1.5rem; margin: 1rem 0; }
+    .tool { margin: 0.75rem 0; }
+    .tool-name { color: var(--accent); font-weight: 600; font-family: monospace; }
+    .tool-desc { color: #8b949e; margin-left: 1rem; }
+    .step { display: flex; gap: 1rem; margin: 1rem 0; }
+    .step-num { background: var(--accent); color: var(--bg); width: 28px; height: 28px; border-radius: 50%; display: flex; align-items: center; justify-content: center; font-weight: 700; flex-shrink: 0; }
+    .warn { background: #3d1f00; border: 1px solid #6e3a00; border-radius: 6px; padding: 1rem; margin: 1rem 0; color: #f0883e; }
+  </style>
+</head>
+<body>
+  <h1>Upfyn-Code MCP Server</h1>
+  <p class="subtitle">Connect any MCP client to control your Upfyn-Code instance</p>
+
+  <h2>Quick Start</h2>
+
+  <div class="step">
+    <div class="step-num">1</div>
+    <div><strong>Get your API key</strong> — Log into Upfyn-Code, go to Settings, then API Keys. Click "Generate New Key".</div>
+  </div>
+  <div class="step">
+    <div class="step-num">2</div>
+    <div><strong>Add MCP config</strong> to your client (see examples below).</div>
+  </div>
+  <div class="step">
+    <div class="step-num">3</div>
+    <div><strong>Start using tools</strong> — Your client can now send prompts, manage canvas, and control sessions.</div>
+  </div>
+
+  <h2>Client Configuration</h2>
+
+  <h3>Claude Desktop</h3>
+  <p>Add to <code>~/.claude/mcp_servers.json</code>:</p>
+  <pre><code>{
+  "upfynai": {
+    "type": "streamable-http",
+    "url": "https://upfynai.thinqmesh.com/mcp",
+    "headers": {
+      "x-api-key": "YOUR_API_KEY_HERE"
+    }
+  }
+}</code></pre>
+
+  <h3>Claude Code CLI</h3>
+  <pre><code>claude mcp add upfynai \
+  --transport streamable-http \
+  https://upfynai.thinqmesh.com/mcp \
+  --header "x-api-key: YOUR_API_KEY_HERE"</code></pre>
+
+  <h3>Cursor</h3>
+  <p>Add to <code>.cursor/mcp.json</code> in your project:</p>
+  <pre><code>{
+  "mcpServers": {
+    "upfynai": {
+      "url": "https://upfynai.thinqmesh.com/mcp",
+      "headers": { "x-api-key": "YOUR_API_KEY_HERE" }
+    }
+  }
+}</code></pre>
+
+  <h3>Any HTTP MCP Client</h3>
+  <pre><code>POST https://upfynai.thinqmesh.com/mcp
+Headers:
+  Content-Type: application/json
+  x-api-key: YOUR_API_KEY_HERE</code></pre>
+
+  <h2>Available Tools</h2>
+  <div class="card">
+    <div class="tool"><span class="tool-name">send-prompt</span><span class="tool-desc">Send a message to Claude and get a streaming response</span></div>
+    <div class="tool"><span class="tool-name">list-projects</span><span class="tool-desc">List all available projects</span></div>
+    <div class="tool"><span class="tool-name">list-sessions</span><span class="tool-desc">List sessions for a specific project</span></div>
+    <div class="tool"><span class="tool-name">get-session-messages</span><span class="tool-desc">Retrieve messages from a session</span></div>
+    <div class="tool"><span class="tool-name">get-canvas-state</span><span class="tool-desc">Get current tldraw canvas nodes</span></div>
+    <div class="tool"><span class="tool-name">add-canvas-node</span><span class="tool-desc">Add a visual node to the canvas</span></div>
+    <div class="tool"><span class="tool-name">clear-canvas</span><span class="tool-desc">Clear all canvas nodes</span></div>
+    <div class="tool"><span class="tool-name">get-active-sessions</span><span class="tool-desc">Get currently running Claude sessions</span></div>
+    <div class="tool"><span class="tool-name">abort-session</span><span class="tool-desc">Stop an active Claude session</span></div>
+  </div>
+
+  <h2>Resources</h2>
+  <div class="card">
+    <div class="tool"><span class="tool-name">upfynai://canvas/state</span><span class="tool-desc">Current canvas state (JSON)</span></div>
+    <div class="tool"><span class="tool-name">upfynai://sessions/active</span><span class="tool-desc">Active sessions list (JSON)</span></div>
+  </div>
+
+  <h2>Authentication</h2>
+  <p>All MCP requests require authentication via one of:</p>
+  <div class="card">
+    <p><strong>API Key</strong> (recommended for external clients):<br><code>x-api-key: ck_your_key_here</code></p>
+    <p><strong>JWT Bearer Token</strong> (for browser-based access):<br><code>Authorization: Bearer eyJhbG...</code></p>
+  </div>
+
+  <div class="warn">
+    <strong>Security:</strong> Keep your API key secret. Each key is tied to your user account. You can revoke keys at any time from Settings.
+  </div>
+
+  <h2>Local Relay Connection</h2>
+  <p>To power Upfyn-Code with your local Claude Code CLI:</p>
+  <pre><code>npx upfynai-code connect --server https://upfynai.thinqmesh.com --key YOUR_API_KEY</code></pre>
+  <p>This connects your local machine's Claude CLI, terminal, filesystem, and git to the hosted UI. All computation runs locally — the server only relays messages.</p>
+</body>
+</html>

package/client/dist/sw.js

@@ -0,0 +1,19 @@
+// Service Worker for Upfyn-Code
+// v3 — self-cleaning: clears all caches and claims clients immediately
+// This ensures old cache-first SWs are replaced cleanly after deploys
+
+self.addEventListener('install', () => {
+  self.skipWaiting();
+});
+
+self.addEventListener('activate', event => {
+  event.waitUntil(
+    caches.keys().then(names => Promise.all(names.map(n => caches.delete(n))))
+  );
+  self.clients.claim();
+});
+
+// Pass everything through to the network — no caching
+self.addEventListener('fetch', event => {
+  event.respondWith(fetch(event.request));
+});

package/commands/upfynai-connect.md

@@ -0,0 +1,46 @@
+---
+description: Connect this Claude Code CLI session to Upfyn-Code web UI
+---
+
+# Upfyn-Code — Connect CLI to Web UI
+
+You are the Upfyn-Code assistant. The user wants to connect their current Claude Code CLI session to the Upfyn-Code web UI.
+
+## What to do
+
+1. First verify the server is running:
+   ```
+   curl -s http://localhost:3001/health 2>/dev/null || echo "NOT_RUNNING"
+   ```
+   If not running, tell the user to run `/upfynai` first.
+
+2. Get the current project path and session info:
+   - Current working directory is the project
+   - The Claude Code session ID is available from the environment
+
+3. Register this project with the UI server by calling the API:
+   ```
+   curl -s -X POST http://localhost:3001/api/projects \
+     -H "Content-Type: application/json" \
+     -d '{"path": "'$(pwd)'"}'
+   ```
+
+4. Display connection confirmation:
+   ```
+   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+   ✅ Connected to Upfyn-Code!
+
+   📁 Project: [current directory]
+   🌐 UI: http://localhost:3001
+   🔗 Session synced — canvas will show your conversation
+
+   Your Claude Code session is now visible in the web UI.
+   Tool calls, responses, and permissions appear as canvas nodes.
+
+   Use /upfynai-disconnect to unlink this session
+   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+   ```
+
+If the user provided a custom URL (like `http://192.168.1.5:3001`), use that instead of localhost.
+
+$ARGUMENTS

package/commands/upfynai-disconnect.md

@@ -0,0 +1,31 @@
+---
+description: Disconnect this CLI session from Upfyn-Code web UI
+---
+
+# Upfyn-Code — Disconnect from Web UI
+
+You are the Upfyn-Code assistant. The user wants to disconnect their Claude Code CLI session from the Upfyn-Code web UI.
+
+## What to do
+
+1. Check if the server is running:
+   ```
+   curl -s http://localhost:3001/health 2>/dev/null || echo "NOT_RUNNING"
+   ```
+
+2. If running, notify the UI that this session is disconnecting. The server will handle cleanup.
+
+3. Display confirmation:
+   ```
+   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+   🔌 Disconnected from Upfyn-Code
+
+   Your CLI session is no longer synced to the web UI.
+   The server is still running at http://localhost:3001
+
+   Use /upfynai-connect to reconnect
+   Use /upfynai-stop to shut down the server
+   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+   ```
+
+$ARGUMENTS

package/commands/upfynai-doctor.md

@@ -0,0 +1,99 @@
+---
+description: Run Upfyn-Code diagnostics — check installation, server, connection, and project config
+---
+
+# Upfyn-Code — Doctor (Diagnostics)
+
+You are the Upfyn-Code assistant. Run a full diagnostic check and report the results.
+
+## Checks to perform
+
+Run each check and report with ✅ (pass), ⚠️ (warning), or ❌ (fail):
+
+1. **Package installed**: Check if `upfynai-code` is installed globally
+   ```
+   npm list -g upfynai-code --depth=0 2>/dev/null
+   ```
+
+2. **Server running**: Check health endpoint
+   ```
+   curl -s http://localhost:3001/health 2>/dev/null
+   ```
+
+3. **Claude Code CLI**: Verify `claude` CLI is available
+   ```
+   which claude 2>/dev/null || where claude 2>/dev/null
+   ```
+
+4. **Node.js version**: Check node version (needs 18+)
+   ```
+   node --version
+   ```
+
+5. **Project .claude directory**: Check if current project has `.claude/` folder
+   ```
+   ls -la .claude/ 2>/dev/null || echo "NO_CLAUDE_DIR"
+   ```
+
+6. **Project CLAUDE.md**: Check if project has CLAUDE.md instructions
+   ```
+   ls CLAUDE.md 2>/dev/null || echo "NO_CLAUDE_MD"
+   ```
+
+7. **User commands directory**: Check `~/.claude/commands/` exists
+   ```
+   ls ~/.claude/commands/ 2>/dev/null || echo "NO_COMMANDS_DIR"
+   ```
+
+8. **Upfyn-Code commands installed**: Check if upfynai slash commands are in `~/.claude/commands/`
+   ```
+   ls ~/.claude/commands/upfynai*.md 2>/dev/null || echo "NOT_INSTALLED"
+   ```
+
+9. **Database**: Check if auth.db exists
+   ```
+   ls ~/.claude/upfynai-code/auth.db 2>/dev/null || echo "NO_DB"
+   ```
+
+10. **Port availability**: Check if port 3001 is in use
+    ```
+    lsof -i :3001 2>/dev/null || netstat -an | grep 3001 2>/dev/null || echo "PORT_FREE"
+    ```
+
+11. **MCP servers**: Check if any MCP servers are configured in `.claude/`
+    ```
+    cat .claude/mcp.json 2>/dev/null || echo "NO_MCP"
+    ```
+
+12. **Settings**: Check Claude settings
+    ```
+    cat ~/.claude/settings.json 2>/dev/null || echo "NO_SETTINGS"
+    ```
+
+## Output format
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Upfyn-Code Doctor — Diagnostics Report
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+[✅/❌] Package installed:     [version or NOT FOUND]
+[✅/❌] Server running:        [status]
+[✅/❌] Claude CLI:            [path]
+[✅/❌] Node.js:               [version]
+[✅/⚠️] Project .claude/:     [found/missing]
+[✅/⚠️] CLAUDE.md:            [found/missing]
+[✅/❌] Commands directory:    [path]
+[✅/⚠️] Upfyn-Code commands:     [installed/missing]
+[✅/⚠️] Database:             [path/missing]
+[✅/⚠️] Port 3001:            [in use/free]
+[✅/⚠️] MCP servers:          [count or none]
+[✅/⚠️] Settings:             [found/missing]
+
+Summary: X passed, Y warnings, Z failed
+
+[If any failures, suggest fixes]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+$ARGUMENTS