vibora 1.15.0 → 2.1.0

package/README.md

@@ -14,9 +14,28 @@ The Vibe Engineer's Cockpit. A terminal-first tool for orchestrating AI coding a
 
 ## Quick Start
 
-Requires [Node.js](https://nodejs.org/) and [Claude Code](https://claude.ai/code).
+Requires [Bun](https://bun.sh/) and [Claude Code](https://claude.ai/code).
 
-### Install via curl (recommended)
+### Desktop App (Recommended)
+
+Download the latest release for your platform from [GitHub Releases](https://github.com/knowsuchagency/vibora/releases/latest):
+
+- **macOS Apple Silicon**: `Vibora-X.X.X-macos-arm64.dmg`
+- **macOS Intel**: `Vibora-X.X.X-macos-x64.dmg`
+- **Linux**: `Vibora-X.X.X-linux-x64.AppImage`
+
+The desktop app bundles everything—just install and run. It will:
+- Start the Vibora server automatically
+- Install the Claude Code plugin
+- Check for updates on startup
+
+> **macOS note**: On first launch, right-click the app and select "Open" to bypass Gatekeeper.
+
+### Web Application (Alternative)
+
+Run Vibora as a web server if you prefer browser access or need remote server deployment.
+
+#### Install via curl
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/knowsuchagency/vibora/main/install.sh | bash
@@ -24,7 +43,7 @@ curl -fsSL https://raw.githubusercontent.com/knowsuchagency/vibora/main/install.
 
 This installs vibora, the Claude Code plugin, and starts the server.
 
-### Install via npm
+#### Install via npm
 
 ```bash
 npx vibora@latest up
@@ -37,7 +56,33 @@ claude plugin marketplace add knowsuchagency/vibora
 claude plugin install vibora@vibora --scope user
 ```
 
-### Server Commands
+Open http://localhost:7777 in your browser.
+
+### Remote Server Setup
+
+Run the backend on a remote server and connect from the desktop app or browser:
+
+1. **On the remote server:**
+   ```bash
+   # Install and start
+   npx vibora@latest up
+
+   # Configure for remote access
+   vibora config set remoteHost your-server.example.com
+   vibora config set basicAuthUsername admin
+   vibora config set basicAuthPassword your-secure-password
+   ```
+
+2. **Connect from desktop app:**
+   - Launch the app
+   - Click "Connect to Remote" (if local server not found)
+   - Enter the server URL: `your-server.example.com:7777`
+   - Enter credentials when prompted
+
+3. **Or access via browser:**
+   Open `http://your-server.example.com:7777`
+
+### Server Commands (Web Application)
 
 ```bash
 vibora up       # Start server daemon
@@ -45,8 +90,6 @@ vibora down     # Stop the server
 vibora status   # Check if running
 ```
 
-Open http://localhost:3333 in your browser.
-
 ## Configuration
 
 Settings are stored in `.vibora/settings.json`. The vibora directory is resolved in this order:
@@ -57,9 +100,9 @@ Settings are stored in `.vibora/settings.json`. The vibora directory is resolved
 
 | Setting | Env Var | Default |
 |---------|---------|---------|
-| port | `PORT` | 3333 |
+| port | `PORT` | 7777 |
 | defaultGitReposDir | `VIBORA_GIT_REPOS_DIR` | ~ |
-| hostname | `VIBORA_HOSTNAME` | (empty) |
+| remoteHost | `VIBORA_REMOTE_HOST` | (empty) |
 | sshPort | `VIBORA_SSH_PORT` | 22 |
 | basicAuthUsername | `VIBORA_BASIC_AUTH_USERNAME` | null |
 | basicAuthPassword | `VIBORA_BASIC_AUTH_PASSWORD` | null |
@@ -169,7 +212,7 @@ vibora notify <title> [message]  # Send a notification to all enabled channels
 ### Global Options
 
 ```bash
---port=<port>     # Server port (default: 3333)
+--port=<port>     # Server port (default: 7777)
 --url=<url>       # Override full server URL
 --pretty          # Pretty-print JSON output
 ```
@@ -189,3 +232,5 @@ See [DEVELOPMENT.md](DEVELOPMENT.md) for development setup, architecture, and co
 ## License
 
 [PolyForm Shield 1.0.0](LICENSE)
+
+**In plain English:** You can use Vibora for any purpose—personal or commercial. KNOWSUCHAGENCY CORP has no claim over the software you build using Vibora. What's prohibited is reselling or redistributing Vibora itself for profit. The software is provided as-is with no warranty.

package/bin/vibora.js

@@ -5,6 +5,35 @@
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
+var DEFAULT_PORT = 7777;
+function getPortFromSettings(settings) {
+  if (!settings)
+    return null;
+  if (settings.server?.port) {
+    return settings.server.port;
+  }
+  if (settings.port) {
+    return settings.port;
+  }
+  return null;
+}
+function getAuthFromSettings(settings) {
+  if (!settings)
+    return null;
+  if (settings.authentication?.username && settings.authentication?.password) {
+    return {
+      username: settings.authentication.username,
+      password: settings.authentication.password
+    };
+  }
+  if (settings.basicAuthUsername && settings.basicAuthPassword) {
+    return {
+      username: settings.basicAuthUsername,
+      password: settings.basicAuthPassword
+    };
+  }
+  return null;
+}
 function expandPath(p) {
   if (p.startsWith("~/")) {
     return join(homedir(), p.slice(2));
@@ -33,21 +62,24 @@ function discoverServerUrl(urlOverride, portOverride) {
   if (process.env.VIBORA_DIR) {
     const viboraDirSettings = join(expandPath(process.env.VIBORA_DIR), "settings.json");
     const settings = readSettingsFile(viboraDirSettings);
-    if (settings?.port) {
-      return `http://localhost:${settings.port}`;
+    const port = getPortFromSettings(settings);
+    if (port) {
+      return `http://localhost:${port}`;
     }
   }
   const cwdSettings = join(process.cwd(), ".vibora", "settings.json");
   const localSettings = readSettingsFile(cwdSettings);
-  if (localSettings?.port) {
-    return `http://localhost:${localSettings.port}`;
+  const localPort = getPortFromSettings(localSettings);
+  if (localPort) {
+    return `http://localhost:${localPort}`;
   }
   const globalSettings = join(homedir(), ".vibora", "settings.json");
   const homeSettings = readSettingsFile(globalSettings);
-  if (homeSettings?.port) {
-    return `http://localhost:${homeSettings.port}`;
+  const homePort = getPortFromSettings(homeSettings);
+  if (homePort) {
+    return `http://localhost:${homePort}`;
   }
-  return "http://localhost:3333";
+  return `http://localhost:${DEFAULT_PORT}`;
 }
 function getViboraDir() {
   if (process.env.VIBORA_DIR) {
@@ -67,11 +99,9 @@ function getAuthCredentials() {
   ].filter(Boolean);
   for (const path of settingsPaths) {
     const settings = readSettingsFile(path);
-    if (settings?.basicAuthUsername && settings?.basicAuthPassword) {
-      return {
-        username: settings.basicAuthUsername,
-        password: settings.basicAuthPassword
-      };
+    const auth = getAuthFromSettings(settings);
+    if (auth) {
+      return auth;
     }
   }
   return null;
@@ -509,7 +539,7 @@ function getPort(portOverride) {
     if (!isNaN(port))
       return port;
   }
-  return 3333;
+  return 7777;
 }
 
 // cli/src/utils/prompt.ts
@@ -917,12 +947,12 @@ async function handleDevCommand(action, flags) {
       if (!devMode.enabled) {
         throw new CliError("DEVELOPER_MODE_REQUIRED", "Developer mode is not enabled. Set VIBORA_DEVELOPER=1 environment variable.", ExitCodes.INVALID_STATE);
       }
-      output({ status: "restarting", message: "Triggering restart (build + restart via systemd)..." });
+      output({ status: "restarting", message: "Triggering restart (build + migrate + restart)..." });
       const result = await client.restartVibora();
       if (result.error) {
         throw new CliError("RESTART_FAILED", result.error, ExitCodes.OPERATION_FAILED);
       }
-      output({ status: "initiated", message: "Restart initiated. If build fails, old instance keeps running." });
+      output({ status: "initiated", message: "Restart initiated. If build or migration fails, old instance keeps running." });
       break;
     }
     case "status": {
@@ -1027,7 +1057,7 @@ Commands:
   dev status                Check if developer mode is enabled
 
 Global Options:
-  --port=<port>     Server port (default: 3333)
+  --port=<port>     Server port (default: 7777)
   --url=<url>       Override full server URL
   --pretty          Pretty-print JSON output
   --version         Show version