@regression-io/claude-config 0.38.6 → 0.38.8

package/README.md

@@ -17,13 +17,36 @@ Claude Code works great out of the box. This tool helps when you need more contr
 
 ## Installation
 
+### Option A: Desktop App (Recommended)
+
+Download the native app from [GitHub Releases](https://github.com/regression-io/claude-config/releases):
+
+| Platform | Download |
+|----------|----------|
+| **macOS (Apple Silicon)** | `Claude.Config_*_aarch64.dmg` |
+| **macOS (Intel)** | `Claude.Config_*_x64.dmg` |
+| **Windows** | `Claude.Config_*_x64-setup.exe` |
+| **Linux** | `Claude.Config_*_amd64.deb` or `.AppImage` |
+
+No Node.js required. Just download, install, and run.
+
+### Option B: npm Package
+
 ```bash
 npm install -g @regression-io/claude-config
 ```
 
+Requires Node.js 18+.
+
 ## Quick Start
 
-### New Users
+### Desktop App Users
+
+1. Download and install from [GitHub Releases](https://github.com/regression-io/claude-config/releases)
+2. Launch the app
+3. Add your projects and configure
+
+### npm Package Users
 
 ```bash
 # 1. Install
@@ -36,25 +59,18 @@ claude-config ui install
 open http://localhost:3333
 ```
 
-The server now starts automatically on login. Install as a PWA from your browser for app-like access.
+The server starts automatically on login. Install as a PWA from your browser for app-like access.
+
+### Updating
 
-### Existing Users (Updating)
+**Desktop App:** Download latest from [GitHub Releases](https://github.com/regression-io/claude-config/releases).
 
+**npm Package:**
 ```bash
-# Option A: Update via CLI
 claude-config update
-
-# Option B: Update via UI
-# Click the green "Update" button in the header when available
-
-# After updating, restart to pick up changes:
-claude-config ui install   # If using auto-start
-# OR
-claude-config ui stop && claude-config ui   # Manual restart
+# Then restart: claude-config ui stop && claude-config ui
 ```
 
-The UI shows a restart indicator when the running version differs from the installed version.
-
 ### CLI Alternative
 
 ```bash
@@ -528,11 +544,22 @@ User settings stored in `~/.claude-config/config.json`:
 | `ui.port` | Default port for web UI |
 | `ui.openBrowser` | Auto-open browser on `claude-config ui` |
 
-## Native Desktop App (Tauri)
+## Native Desktop App
+
+The desktop app provides a true native experience - no terminal, no Node.js, no CLI commands.
 
-For a true desktop experience without running CLI commands, you can build a native macOS app.
+### Download
 
-### Building the Desktop App
+Get the latest release from [GitHub Releases](https://github.com/regression-io/claude-config/releases):
+
+- **macOS Apple Silicon**: `Claude.Config_*_aarch64.dmg`
+- **macOS Intel**: `Claude.Config_*_x64.dmg`
+- **Windows**: `Claude.Config_*_x64-setup.exe`
+- **Linux**: `Claude.Config_*_amd64.deb` or `.AppImage`
+
+### Building from Source
+
+If you prefer to build locally:
 
 ```bash
 # Prerequisites: Rust toolchain
@@ -551,8 +578,6 @@ The `.app` bundle will be created in `src-tauri/target/release/bundle/macos/`.
 npm run tauri:dev
 ```
 
-This opens the native window connected to the local Node.js server.
-
 ## Requirements
 
 - Node.js 18+

package/lib/constants.js

@@ -2,7 +2,7 @@
  * Constants and tool path configurations
  */
 
-const VERSION = '0.38.6';
+const VERSION = '0.38.8';
 
 // Tool-specific path configurations
 const TOOL_PATHS = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@regression-io/claude-config",
-  "version": "0.38.6",
+  "version": "0.38.8",
   "description": "Configuration management UI for Claude Code and Antigravity - manage MCPs, rules, commands, memory, and project folders",
   "author": "regression.io",
   "main": "config-loader.js",

package/scripts/tauri-prepare.js

@@ -0,0 +1,300 @@
+#!/usr/bin/env node
+
+/**
+ * Tauri Build Preparation Script
+ *
+ * Prepares the Node.js server bundle for Tauri packaging:
+ * 1. Downloads Node.js binary for target platform
+ * 2. Copies server files to bundle location
+ * 3. Installs production dependencies
+ */
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const { spawnSync } = require('child_process');
+const os = require('os');
+
+const ROOT_DIR = path.join(__dirname, '..');
+const SRC_TAURI = path.join(ROOT_DIR, 'src-tauri');
+const BINARIES_DIR = path.join(SRC_TAURI, 'binaries');
+const SERVER_DIR = path.join(SRC_TAURI, 'server');
+
+// Node.js version to bundle (LTS)
+const NODE_VERSION = '20.18.1';
+
+// Platform detection
+function getPlatform() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  if (platform === 'darwin') {
+    return arch === 'arm64' ? 'darwin-arm64' : 'darwin-x64';
+  } else if (platform === 'win32') {
+    return arch === 'arm64' ? 'win-arm64' : 'win-x64';
+  } else if (platform === 'linux') {
+    return arch === 'arm64' ? 'linux-arm64' : 'linux-x64';
+  }
+
+  throw new Error(`Unsupported platform: ${platform}-${arch}`);
+}
+
+// Get Tauri target triple
+function getTauriTarget() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  if (platform === 'darwin') {
+    return arch === 'arm64' ? 'aarch64-apple-darwin' : 'x86_64-apple-darwin';
+  } else if (platform === 'win32') {
+    return arch === 'arm64' ? 'aarch64-pc-windows-msvc' : 'x86_64-pc-windows-msvc';
+  } else if (platform === 'linux') {
+    return arch === 'arm64' ? 'aarch64-unknown-linux-gnu' : 'x86_64-unknown-linux-gnu';
+  }
+
+  throw new Error(`Unsupported platform: ${platform}-${arch}`);
+}
+
+// Download a file
+async function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    console.log(`Downloading: ${url}`);
+
+    const file = fs.createWriteStream(dest);
+
+    const request = (reqUrl) => {
+      https.get(reqUrl, (response) => {
+        if (response.statusCode === 302 || response.statusCode === 301) {
+          // Follow redirect
+          request(response.headers.location);
+          return;
+        }
+
+        if (response.statusCode !== 200) {
+          reject(new Error(`HTTP ${response.statusCode}: ${reqUrl}`));
+          return;
+        }
+
+        const total = parseInt(response.headers['content-length'], 10);
+        let downloaded = 0;
+
+        response.on('data', (chunk) => {
+          downloaded += chunk.length;
+          if (total) {
+            const pct = Math.round((downloaded / total) * 100);
+            process.stdout.write(`\r  Progress: ${pct}%`);
+          }
+        });
+
+        response.pipe(file);
+
+        file.on('finish', () => {
+          file.close();
+          console.log('\n  Download complete');
+          resolve();
+        });
+      }).on('error', (err) => {
+        fs.unlink(dest, () => {});
+        reject(err);
+      });
+    };
+
+    request(url);
+  });
+}
+
+// Extract tar.gz using spawn (safe from injection)
+function extractArchive(archivePath, destDir) {
+  console.log(`Extracting to: ${destDir}`);
+
+  // Use spawnSync with array arguments (safe from shell injection)
+  const result = spawnSync('tar', ['-xzf', archivePath, '-C', destDir], {
+    stdio: 'inherit'
+  });
+
+  if (result.status !== 0) {
+    throw new Error(`Failed to extract archive: ${result.stderr || 'unknown error'}`);
+  }
+}
+
+// Download Node.js binary
+async function downloadNode() {
+  const platform = getPlatform();
+  const tauriTarget = getTauriTarget();
+  const ext = platform.startsWith('win') ? 'zip' : 'tar.gz';
+  const nodeDir = `node-v${NODE_VERSION}-${platform}`;
+  const archiveName = `${nodeDir}.${ext}`;
+  const url = `https://nodejs.org/dist/v${NODE_VERSION}/${archiveName}`;
+
+  console.log(`\n=== Downloading Node.js ${NODE_VERSION} for ${platform} ===`);
+
+  // Create directories
+  if (!fs.existsSync(BINARIES_DIR)) {
+    fs.mkdirSync(BINARIES_DIR, { recursive: true });
+  }
+
+  const archivePath = path.join(BINARIES_DIR, archiveName);
+  const extractDir = BINARIES_DIR;
+
+  // Download if not already present
+  if (!fs.existsSync(archivePath)) {
+    await downloadFile(url, archivePath);
+  } else {
+    console.log('  Archive already exists, skipping download');
+  }
+
+  // Extract
+  extractArchive(archivePath, extractDir);
+
+  // Move node binary to expected location with Tauri naming convention
+  const sourceDir = path.join(extractDir, nodeDir);
+  const isWindows = platform.startsWith('win');
+  const sourceNode = path.join(sourceDir, isWindows ? 'node.exe' : 'bin/node');
+
+  // Tauri sidecar naming: <name>-<target-triple>[.exe]
+  const destNodeName = `node-server-${tauriTarget}${isWindows ? '.exe' : ''}`;
+  const destNode = path.join(BINARIES_DIR, destNodeName);
+
+  if (fs.existsSync(sourceNode)) {
+    fs.copyFileSync(sourceNode, destNode);
+    fs.chmodSync(destNode, 0o755);
+    console.log(`  Node binary copied to: ${destNodeName}`);
+  }
+
+  // Clean up extracted directory (keep archive for caching)
+  fs.rmSync(sourceDir, { recursive: true, force: true });
+
+  return destNode;
+}
+
+// Copy server files
+function copyServerFiles() {
+  console.log('\n=== Copying server files ===');
+
+  // Create server directory
+  if (fs.existsSync(SERVER_DIR)) {
+    fs.rmSync(SERVER_DIR, { recursive: true });
+  }
+  fs.mkdirSync(SERVER_DIR, { recursive: true });
+
+  // Files to copy (individual files)
+  const filesToCopy = [
+    'cli.js',
+    'config-loader.js',
+    'package.json',
+    'ui/server.cjs',
+    'ui/terminal-server.cjs',
+  ];
+
+  // Directories to copy (recursive)
+  const dirsToCopy = [
+    'lib',
+    'ui/routes',
+    'ui/dist',
+    'shared',
+  ];
+
+  // Copy individual files
+  for (const file of filesToCopy) {
+    const src = path.join(ROOT_DIR, file);
+    const dest = path.join(SERVER_DIR, file);
+    if (fs.existsSync(src)) {
+      // Ensure destination directory exists
+      fs.mkdirSync(path.dirname(dest), { recursive: true });
+      fs.copyFileSync(src, dest);
+      console.log(`  Copied: ${file}`);
+    }
+  }
+
+  // Copy directories
+  for (const dir of dirsToCopy) {
+    const src = path.join(ROOT_DIR, dir);
+    const dest = path.join(SERVER_DIR, dir);
+    if (fs.existsSync(src)) {
+      copyDirSync(src, dest);
+      console.log(`  Copied: ${dir}/`);
+    }
+  }
+}
+
+// Recursive directory copy
+function copyDirSync(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirSync(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+// Install production dependencies
+function installDependencies() {
+  console.log('\n=== Installing production dependencies ===');
+
+  const result = spawnSync('npm', ['install', '--production', '--ignore-scripts'], {
+    cwd: SERVER_DIR,
+    stdio: 'inherit',
+    shell: true
+  });
+
+  if (result.status !== 0) {
+    console.warn('  Warning: npm install may have had issues');
+  }
+
+  // Note: node-pty needs to be rebuilt for the target platform
+  // This is handled by npm rebuild during the Tauri build
+  console.log('  Dependencies installed');
+}
+
+// Create a wrapper script for the sidecar
+function createWrapperScript() {
+  console.log('\n=== Creating wrapper script ===');
+
+  const wrapperPath = path.join(SERVER_DIR, 'start-server.js');
+  const wrapperContent = `#!/usr/bin/env node
+// Wrapper script to start the server
+// Used by Tauri sidecar
+process.chdir(__dirname);
+require('./cli.js');
+`;
+
+  fs.writeFileSync(wrapperPath, wrapperContent);
+  fs.chmodSync(wrapperPath, 0o755);
+  console.log('  Wrapper script created');
+}
+
+// Main
+async function main() {
+  console.log('=== Claude Config Tauri Build Preparation ===\n');
+
+  try {
+    // Check if we're building for distribution or just development
+    const args = process.argv.slice(2);
+    const skipNodeDownload = args.includes('--skip-node');
+
+    if (!skipNodeDownload) {
+      await downloadNode();
+    }
+
+    copyServerFiles();
+    installDependencies();
+    createWrapperScript();
+
+    console.log('\n=== Build preparation complete! ===');
+    console.log('Run `npm run tauri:build` to create the app bundle.');
+
+  } catch (error) {
+    console.error('Build preparation failed:', error);
+    process.exit(1);
+  }
+}
+
+main();

package/ui/dist/assets/{index-DTADVG7R.js → index-BGKsqCBk.js}

@@ -631,44 +631,52 @@ ${x.description}`;break;case"history":case"context":default:if(!x.content.trim()
 This won't delete any files.`))try{const v=await we.removeProject(_.id);v.success?(r(y=>y.filter(x=>x.id!==_.id)),Z.success(`Removed project: ${_.name}`)):Z.error(v.error||"Failed to remove project")}catch(v){Z.error("Failed to remove project: "+v.message)}},k=_=>{r(v=>[...v,{..._,exists:!0,hasClaudeConfig:!1}])};return u?n.jsx("div",{className:"flex items-center justify-center h-64",children:n.jsx(dt,{className:"w-8 h-8 animate-spin text-indigo-600"})}):n.jsxs("div",{className:"space-y-6",children:[n.jsxs("div",{className:"flex items-center justify-between",children:[n.jsxs("div",{className:"flex items-center gap-3",children:[n.jsx("div",{className:"w-10 h-10 rounded-lg bg-indigo-100 dark:bg-indigo-900/30 flex items-center justify-center",children:n.jsx(ai,{className:"w-5 h-5 text-indigo-600 dark:text-indigo-400"})}),n.jsxs("div",{children:[n.jsx("h2",{className:"text-lg font-semibold text-gray-900 dark:text-white",children:"Projects"}),n.jsx("p",{className:"text-sm text-gray-500 dark:text-slate-400",children:"Registered projects for quick switching"})]})]}),n.jsxs("div",{className:"flex gap-2",children:[n.jsxs(le,{variant:"outline",onClick:h,size:"sm",children:[n.jsx(dr,{className:"w-4 h-4 mr-2"}),"Refresh"]}),n.jsxs(le,{onClick:()=>m(!0),className:"bg-indigo-600 hover:bg-indigo-700",children:[n.jsx(_t,{className:"w-4 h-4 mr-2"}),"Add Project"]})]})]}),n.jsx("div",{className:"bg-blue-50 dark:bg-blue-950/30 border border-blue-200 dark:border-blue-800 rounded-lg p-4 text-sm text-blue-700 dark:text-blue-400",children:n.jsx("p",{children:"Projects registered here can be quickly switched in the header dropdown. The UI will update to show the selected project's configuration."})}),n.jsx("div",{className:"bg-white dark:bg-slate-950 rounded-xl border border-gray-200 dark:border-slate-800 shadow-sm overflow-hidden",children:t.length===0?n.jsxs("div",{className:"p-12 text-center",children:[n.jsx(gr,{className:"w-12 h-12 mx-auto mb-4 text-gray-300 dark:text-slate-600"}),n.jsx("h3",{className:"text-lg font-medium text-gray-900 dark:text-white mb-2",children:"No Projects Yet"}),n.jsx("p",{className:"text-sm text-gray-500 dark:text-slate-400 mb-4",children:"Add your first project to get started with quick switching."}),n.jsxs(le,{onClick:()=>m(!0),children:[n.jsx(_t,{className:"w-4 h-4 mr-2"}),"Add Your First Project"]})]}):n.jsx("div",{className:"divide-y divide-gray-100 dark:divide-slate-800",children:t.map(_=>n.jsxs("div",{className:`p-4 flex items-center gap-4 transition-colors ${_.isActive?"bg-indigo-50 dark:bg-indigo-950/30":"hover:bg-gray-50 dark:hover:bg-slate-900"}`,children:[n.jsx("div",{className:`w-10 h-10 rounded-lg flex items-center justify-center ${_.isActive?"bg-indigo-100 dark:bg-indigo-900/50":_.exists?"bg-gray-100 dark:bg-slate-800":"bg-amber-100 dark:bg-amber-900/30"}`,children:_.isActive?n.jsx(Et,{className:"w-5 h-5 text-indigo-600 dark:text-indigo-400"}):_.exists?n.jsx(gr,{className:"w-5 h-5 text-gray-500 dark:text-slate-400"}):n.jsx(Ju,{className:"w-5 h-5 text-amber-600 dark:text-amber-400"})}),n.jsxs("div",{className:"flex-1 min-w-0",children:[n.jsxs("div",{className:"flex items-center gap-2",children:[n.jsx("h3",{className:`font-medium truncate ${_.isActive?"text-indigo-700 dark:text-indigo-400":"text-gray-900 dark:text-white"}`,children:_.name}),_.hasClaudeConfig&&n.jsx("span",{className:"text-xs bg-green-100 dark:bg-green-900/30 text-green-700 dark:text-green-400 px-1.5 py-0.5 rounded",children:".claude"}),_.isActive&&n.jsx("span",{className:"text-xs bg-indigo-100 dark:bg-indigo-900/50 text-indigo-700 dark:text-indigo-400 px-1.5 py-0.5 rounded",children:"Active"})]}),n.jsx("p",{className:"text-sm text-gray-500 dark:text-slate-400 font-mono truncate",children:_.path.replace(/^\/Users\/[^/]+/,"~")}),!_.exists&&n.jsx("p",{className:"text-xs text-amber-600 dark:text-amber-400 mt-1",children:"Path not found - the directory may have been moved or deleted"})]}),n.jsxs("div",{className:"flex items-center gap-2",children:[!_.isActive&&_.exists&&n.jsx(le,{size:"sm",onClick:()=>g(_.id),disabled:l===_.id,children:l===_.id?n.jsx(dt,{className:"w-4 h-4 animate-spin"}):"Select"}),n.jsx(le,{size:"sm",variant:"ghost",onClick:()=>w(_),className:"text-gray-500 dark:text-slate-400 hover:text-red-600 dark:hover:text-red-400",title:"Remove from registry",children:n.jsx(Fn,{className:"w-4 h-4"})})]})]},_.id))})}),n.jsxs("div",{className:"bg-gray-50 dark:bg-slate-900 rounded-lg p-4 border border-transparent dark:border-slate-800",children:[n.jsx("h4",{className:"text-sm font-medium text-gray-900 dark:text-white mb-2",children:"CLI Commands"}),n.jsxs("div",{className:"space-y-1 text-sm text-gray-600 dark:text-slate-400 font-mono",children:[n.jsx("p",{children:"claude-config project add [path]        # Add project"}),n.jsx("p",{children:"claude-config project remove <name>    # Remove project"}),n.jsx("p",{children:"claude-config project                   # List projects"})]})]}),n.jsx(Rj,{open:f,onOpenChange:m,onAdded:k})]})}const lH=[{id:"getting-started",title:"Getting Started",icon:Li,subsections:[{id:"installation",title:"Installation"},{id:"quick-start",title:"Quick Start"},{id:"updating",title:"Updating"}]},{id:"projects",title:"Project Management",icon:ri,subsections:[{id:"project-registry",title:"Project Registry"},{id:"project-switching",title:"Switching Projects"},{id:"project-structure",title:"Project Structure"}]},{id:"file-explorer",title:"Project Explorer",icon:gr,subsections:[{id:"claude-folders",title:".claude Folders"},{id:"rules",title:"Rules"},{id:"commands",title:"Commands"},{id:"workflows",title:"Workflows"},{id:"hierarchy",title:"Configuration Hierarchy"},{id:"subprojects",title:"Sub-Projects"}]},{id:"workstreams",title:"Workstreams",icon:ri,isNew:!0,subsections:[{id:"workstreams-overview",title:"Overview"},{id:"creating-workstreams",title:"Creating Workstreams"},{id:"workstream-hooks",title:"Hook Integration"},{id:"activity-tracking",title:"Activity Tracking"},{id:"smart-sync",title:"Smart Sync"}]},{id:"plugins",title:"Plugins",icon:ns,isNew:!0,subsections:[{id:"plugins-overview",title:"Overview"},{id:"installing-plugins",title:"Installing Plugins"},{id:"plugin-marketplaces",title:"Marketplaces"}]},{id:"mcp-registry",title:"MCP Registry",icon:ns,subsections:[{id:"mcp-overview",title:"Overview"},{id:"adding-mcps",title:"Adding MCPs"},{id:"configuring-mcps",title:"Configuring MCPs"},{id:"environment-vars",title:"Environment Variables"}]},{id:"memory",title:"Memory System",icon:Ii,subsections:[{id:"memory-overview",title:"Overview"},{id:"global-memory",title:"Global Memory"},{id:"project-memory",title:"Project Memory"},{id:"memory-entries",title:"Memory Entry Types"}]},{id:"claude-settings",title:"Claude Code Settings",icon:Ps,subsections:[{id:"permissions",title:"Permissions"},{id:"model-selection",title:"Model Selection"},{id:"behavior",title:"Behavior Settings"},{id:"hooks",title:"Hooks"}]},{id:"gemini-settings",title:"Gemini CLI Settings",icon:Jt,isNew:!0,subsections:[{id:"gemini-model",title:"Model Selection"},{id:"gemini-display",title:"Display Options"},{id:"gemini-general",title:"General Settings"},{id:"gemini-sandbox",title:"Sandbox Mode"}]},{id:"antigravity-settings",title:"Antigravity Settings",icon:Sl,isNew:!0,subsections:[{id:"antigravity-security",title:"Security Policies"},{id:"antigravity-mcp",title:"MCP Servers"},{id:"antigravity-browser",title:"Browser Allowlist"},{id:"antigravity-agent",title:"Agent Mode"}]},{id:"cli",title:"CLI Reference",icon:Jt,subsections:[{id:"cli-overview",title:"Overview"},{id:"cli-commands",title:"All Commands"},{id:"daemon-mode",title:"Daemon Mode"}]},{id:"multi-tool",title:"Multi-Tool Support",icon:Gt,subsections:[{id:"supported-tools",title:"Supported Tools"},{id:"gemini-cli",title:"Gemini CLI"},{id:"antigravity",title:"Antigravity"},{id:"tool-differences",title:"Tool Differences"},{id:"enabling-tools",title:"Enabling Tools"},{id:"syncing-rules",title:"Syncing Rules"}]},{id:"keyboard",title:"Keyboard Shortcuts",icon:eM,subsections:[]},{id:"troubleshooting",title:"Troubleshooting",icon:al,subsections:[{id:"common-issues",title:"Common Issues"},{id:"getting-help",title:"Getting Help"}]}],cH={installation:{title:"Installation",content:`
 ## Installation
 
-Install claude-config globally via npm:
+Choose your preferred installation method:
 
-\`\`\`bash
-npm install -g @regression-io/claude-config
-\`\`\`
+### Option A: Desktop App (Recommended)
 
-Or install from GitHub directly:
+Download the native app from [GitHub Releases](https://github.com/regression-io/claude-config/releases):
 
-\`\`\`bash
-npm install -g github:regression-io/claude-config
-\`\`\`
+| Platform | Download |
+|----------|----------|
+| **macOS (Apple Silicon)** | \`Claude.Config_*_aarch64.dmg\` |
+| **macOS (Intel)** | \`Claude.Config_*_x64.dmg\` |
+| **Windows** | \`Claude.Config_*_x64-setup.exe\` |
+| **Linux** | \`Claude.Config_*_amd64.deb\` or \`.AppImage\` |
 
-### Requirements
+The desktop app bundles everything - no Node.js or npm required. Just download, install, and run.
 
-- **Node.js 18+** is required
-- Works on macOS, Linux, and Windows (with some limitations)
+### Option B: npm Package (CLI)
 
-### Verify Installation
+Install globally via npm:
 
-After installation, verify it's working:
+\`\`\`bash
+npm install -g @regression-io/claude-config
+\`\`\`
+
+**Requirements:** Node.js 18+
+
+Verify installation:
 
 \`\`\`bash
 claude-config --version
 \`\`\`
 
-This should display the version number and installation paths.
+Then start the UI:
+
+\`\`\`bash
+claude-config ui
+\`\`\`
     `},"quick-start":{title:"Quick Start",content:`
 ## Quick Start
 
 Claude Code works great out of the box. This tool helps you manage its configuration visually.
 
-### 1. Start the Config UI
+### 1. Launch Claude Config
 
-\`\`\`bash
-claude-config ui
-\`\`\`
+**Desktop App:** Double-click the app after installing from GitHub Releases.
 
-This opens a web UI for managing Claude Code settings.
+**CLI:** Run \`claude-config ui\` in your terminal.
 
 ### 2. Add Your Projects
 
@@ -692,25 +700,27 @@ claude
 
 Claude Code automatically reads configuration from the \`.claude/\` folder.
 
-### Optional: Install as App
+### Optional: Install as PWA
 
-The UI is a PWA - install it to your taskbar via Chrome/Edge's install button or Safari's Share → Add to Dock.
+Using the CLI version? The UI is a PWA - install it to your taskbar via Chrome/Edge's install button or Safari's Share → Add to Dock.
     `},updating:{title:"Updating",content:`
 ## Updating
 
-### Automatic Update Detection
+### Desktop App
+
+Download the latest version from [GitHub Releases](https://github.com/regression-io/claude-config/releases) and install over your existing installation.
+
+### npm Package
 
 The UI automatically checks npm for new versions. When an update is available, you'll see a notification in the Preferences page.
 
-### Manual Update
+**Manual update:**
 
 \`\`\`bash
 npm install -g @regression-io/claude-config@latest
 \`\`\`
 
-### After Updating
-
-If you have the UI running as a daemon, restart it:
+**After updating (if using daemon mode):**
 
 \`\`\`bash
 claude-config ui stop
@@ -2383,6 +2393,14 @@ This cannot be undone.`))try{const Le=await we.deleteWorkstream(re.id);Le.succes
 Defaulting to \`null\`.`}var z2=O2,OH=F2;const H2=C.forwardRef(({className:e,value:t,...r},s)=>n.jsx(z2,{ref:s,className:Ne("relative h-2 w-full overflow-hidden rounded-full bg-primary/20",e),...r,children:n.jsx(OH,{className:"h-full w-full flex-1 bg-primary transition-all",style:{transform:`translateX(-${100-(t||0)}%)`}})}));H2.displayName=z2.displayName;const Ha=[{id:"welcome",title:"Welcome",icon:Gt,subsections:[{id:"intro",title:"What is Claude Config?"},{id:"what-youll-learn",title:"What You'll Learn"}]},{id:"first-project",title:"Your First Project",icon:ni,subsections:[{id:"adding-project",title:"Adding a Project"},{id:"exploring-project",title:"Exploring Your Project"},{id:"claude-folder",title:"The .claude Folder"}]},{id:"rules-guide",title:"Working with Rules",icon:br,subsections:[{id:"what-are-rules",title:"What Are Rules?"},{id:"creating-rules",title:"Creating Your First Rule"},{id:"rule-tips",title:"Tips for Great Rules"}]},{id:"mcp-guide",title:"MCP Servers",icon:ns,subsections:[{id:"what-are-mcps",title:"What Are MCPs?"},{id:"adding-mcp",title:"Adding Your First MCP"},{id:"mcp-config",title:"Configuring MCPs"}]},{id:"permissions-guide",title:"Permissions",icon:Ps,subsections:[{id:"understanding-permissions",title:"How Permissions Work"},{id:"setting-permissions",title:"Setting Up Permissions"},{id:"permission-patterns",title:"Permission Patterns"}]},{id:"memory-guide",title:"Memory System",icon:Ii,subsections:[{id:"what-is-memory",title:"What is Memory?"},{id:"using-memory",title:"Using Memory"}]},{id:"plugins-guide",title:"Plugins",icon:Fi,subsections:[{id:"what-are-plugins",title:"What Are Plugins?"},{id:"installing-plugin",title:"Installing a Plugin"}]},{id:"workstreams-guide",title:"Workstreams",icon:Qa,subsections:[{id:"what-are-workstreams",title:"What Are Workstreams?"},{id:"creating-workstream",title:"Creating a Workstream"}]},{id:"multi-tool-guide",title:"Multi-Tool Support",icon:Qn,subsections:[{id:"other-tools",title:"Beyond Claude Code"},{id:"syncing-tools",title:"Syncing Between Tools"}]},{id:"next-steps",title:"Next Steps",icon:Sl,subsections:[]}],BH={intro:{title:"What is Claude Config?",content:`
 Think of Claude Config as your **control center** for Claude Code (and other AI coding tools). Instead of manually editing JSON files or remembering command-line flags, you get a friendly UI to manage everything.
 
+### How are you using Claude Config?
+
+**Desktop App** - Downloaded from [GitHub Releases](https://github.com/regression-io/claude-config/releases). No terminal needed!
+
+**npm Package** - Installed via \`npm install -g @regression-io/claude-config\` and running \`claude-config ui\`.
+
+Both work identically - this tutorial applies to either.
+
 ### What can you do here?
 
 - **Register projects** you're working on
@@ -3217,7 +3235,7 @@ Click **"Create MCP"** to build your own MCP server. Great for connecting Claude
 - \`Cmd/Ctrl + ,\` - Open preferences
 - \`Cmd/Ctrl + R\` - Refresh
 
-**Useful CLI Commands**
+**For CLI Users**
 \`\`\`bash
 claude-config ui          # Start the UI
 claude-config ui stop     # Stop the daemon
@@ -3225,6 +3243,8 @@ claude-config apply       # Apply config to current project
 claude-config --help      # See all commands
 \`\`\`
 
+*Desktop app users: These commands are optional - the app handles everything automatically.*
+
 ### Thank You!
 
 Thanks for using Claude Config. We built this to make working with AI coding tools easier and more powerful.

package/ui/dist/index.html

@@ -19,7 +19,7 @@
 
     <!-- PWA Manifest -->
     <link rel="manifest" href="/manifest.json">
-    <script type="module" crossorigin src="/assets/index-DTADVG7R.js"></script>
+    <script type="module" crossorigin src="/assets/index-BGKsqCBk.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-1RcqzPnS.css">
   </head>
   <body>

package/ui/routes/subprojects.js

@@ -119,7 +119,7 @@ function addManualSubproject(config, saveConfig, projectDir, subprojectDir) {
     saveConfig(config);
   }
 
-  return { success: true };
+  return { success: true, resolvedPath: resolvedSubproject };
 }
 
 /**