knowsuchagency
diff --git a/‎.claude-plugin/marketplace.json‎
Lines changed: 1 addition & 1 deletion b/‎.claude-plugin/marketplace.json‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎.github/workflows/publish.yml‎
Lines changed: 153 additions & 1 deletion b/‎.github/workflows/publish.yml‎
Lines changed: 153 additions & 1 deletion
diff --git a/‎.gitignore‎
Lines changed: 5 additions & 0 deletions b/‎.gitignore‎
Lines changed: 5 additions & 0 deletions
diff --git a/‎CLAUDE.md‎
Lines changed: 78 additions & 0 deletions b/‎CLAUDE.md‎
Lines changed: 78 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 52 additions & 7 deletions b/‎README.md‎
Lines changed: 52 additions & 7 deletions
@@ -8,7 +8,7 @@
       "name": "vibora",
       "source": "./plugins/vibora",
       "description": "Task orchestration for Claude Code",
-      "version": "1.15.0"
+      "version": "2.0.0"
     }
   ]
 }
@@ -12,6 +12,10 @@ jobs:
     permissions:
       contents: write
       id-token: write  # Required for OIDC
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+      tag: ${{ steps.version.outputs.tag }}
+      should_release: ${{ steps.check_tag.outputs.exists == 'false' }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -53,6 +57,10 @@ jobs:
         if: steps.check_tag.outputs.exists == 'false'
         run: bun install
 
+      - name: Verify version sync
+        if: steps.check_tag.outputs.exists == 'false'
+        run: mise run check:version
+
       - name: Build CLI
         if: steps.check_tag.outputs.exists == 'false'
         run: mise run cli:build
@@ -61,6 +69,8 @@ jobs:
         if: steps.check_tag.outputs.exists == 'false'
         working-directory: cli
         run: npm publish --access public --provenance
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
       - name: Create and push tag
         if: steps.check_tag.outputs.exists == 'false'
@@ -84,19 +94,161 @@ jobs:
           echo "$CHANGELOG" >> $GITHUB_OUTPUT
           echo "EOF" >> $GITHUB_OUTPUT
 
-      - name: Create GitHub Release
+      - name: Create GitHub Release (Draft)
         if: steps.check_tag.outputs.exists == 'false'
         uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ steps.version.outputs.tag }}
           name: ${{ steps.version.outputs.tag }}
+          draft: true
           body: |
             ## Changes
 
             ${{ steps.changelog.outputs.changelog }}
 
             ## Installation
 
+            ### Desktop App (Recommended)
+
+            Download the appropriate package for your platform:
+            - **macOS Apple Silicon**: `Vibora-${{ steps.version.outputs.version }}-macos-arm64.dmg`
+            - **macOS Intel**: `Vibora-${{ steps.version.outputs.version }}-macos-x64.dmg`
+            - **Linux**: `Vibora-${{ steps.version.outputs.version }}-linux-x64.AppImage`
+
+            ### CLI
+
             ```bash
             npm install -g vibora
             ```
+
+  # Desktop builds - run in parallel on multiple platforms
+  build-desktop:
+    needs: publish
+    if: needs.publish.outputs.should_release == 'true'
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # macOS Apple Silicon
+          - os: macos-latest
+            platform: macos
+            arch: arm64
+            artifact: Vibora-${{ needs.publish.outputs.version }}-macos-arm64.dmg
+          # macOS Intel
+          - os: macos-13
+            platform: macos
+            arch: x64
+            artifact: Vibora-${{ needs.publish.outputs.version }}-macos-x64.dmg
+          # Linux x64
+          - os: ubuntu-latest
+            platform: linux
+            arch: x64
+            artifact: Vibora-${{ needs.publish.outputs.version }}-linux-x64.AppImage
+
+    runs-on: ${{ matrix.os }}
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+
+      - name: Setup mise
+        uses: jdx/mise-action@v2
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Install create-dmg (macOS)
+        if: matrix.platform == 'macos'
+        run: brew install create-dmg
+
+      - name: Install Linux dependencies
+        if: matrix.platform == 'linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libfuse2
+
+      - name: Build Neutralino app
+        run: mise run desktop:build
+
+      - name: Bundle server
+        run: mise run desktop:bundle
+
+      - name: Package DMG (macOS)
+        if: matrix.platform == 'macos'
+        run: ./desktop/scripts/package-dmg.sh ${{ matrix.arch }}
+
+      - name: Package AppImage (Linux)
+        if: matrix.platform == 'linux'
+        run: ./desktop/scripts/package-appimage.sh ${{ matrix.arch }}
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: desktop-${{ matrix.platform }}-${{ matrix.arch }}
+          path: desktop/dist/${{ matrix.artifact }}
+
+  # Finalize release with all desktop builds
+  finalize-release:
+    needs: [publish, build-desktop]
+    if: needs.publish.outputs.should_release == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download all desktop artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+          pattern: desktop-*
+
+      - name: Generate update manifest
+        run: |
+          VERSION="${{ needs.publish.outputs.version }}"
+          TAG="${{ needs.publish.outputs.tag }}"
+          REPO="${{ github.repository }}"
+
+          cat > manifest.json << EOF
+          {
+            "applicationId": "io.vibora.desktop",
+            "version": "${VERSION}",
+            "platforms": {
+              "darwin-arm64": {
+                "url": "https://github.com/${REPO}/releases/download/${TAG}/Vibora-${VERSION}-macos-arm64.dmg"
+              },
+              "darwin-x64": {
+                "url": "https://github.com/${REPO}/releases/download/${TAG}/Vibora-${VERSION}-macos-x64.dmg"
+              },
+              "linux-x64": {
+                "url": "https://github.com/${REPO}/releases/download/${TAG}/Vibora-${VERSION}-linux-x64.AppImage"
+              }
+            }
+          }
+          EOF
+
+          echo "Generated manifest.json:"
+          cat manifest.json
+
+      - name: Flatten artifacts
+        run: |
+          mkdir -p release-assets
+          find artifacts -type f \( -name "*.dmg" -o -name "*.AppImage" \) -exec cp {} release-assets/ \;
+          cp manifest.json release-assets/
+          ls -la release-assets/
+
+      - name: Upload assets to release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ needs.publish.outputs.tag }}
+          draft: false
+          files: release-assets/*
@@ -40,5 +40,10 @@ cli/bin/
 cli/README.md
 cli/LICENSE
 
+# Desktop build artifacts (generated by mise run desktop:*)
+desktop/bundle/
+desktop/resources/js/neutralino.js
+desktop/resources/js/neutralino.d.ts
+
 # Claude
 CLAUDE.local.md
@@ -146,6 +146,84 @@ When a task status changes in Vibora, the linked Linear ticket status is updated
 - `DONE` → "Done"
 - `CANCELED` → "Canceled"
 
+## Logging
+
+Vibora uses a centralized JSON Lines (JSONL) logging system optimized for AI analysis and debugging.
+
+### Log Format
+
+Each log entry is a single JSON line:
+```json
+{"ts":"2024-12-24T15:30:00.123Z","lvl":"info","src":"PTYManager","msg":"Restored terminal","ctx":{"terminalId":"abc-123","name":"Terminal 1"}}
+```
+
+### Log Locations
+
+| Platform | Location |
+|----------|----------|
+| Development | stdout (terminal) |
+| Production daemon | `~/.vibora/server.log` (stdout) + `~/.vibora/vibora.log` |
+| Desktop app | `~/.vibora/vibora.log` |
+
+### Log Levels
+
+| Level | Use Case |
+|-------|----------|
+| `debug` | Detailed diagnostics (message payloads, state changes) |
+| `info` | Normal operations (terminal created, server started) |
+| `warn` | Recoverable issues (retry, fallback used) |
+| `error` | Failures needing attention |
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `LOG_LEVEL` | `info` | Backend minimum log level |
+| `VITE_LOG_LEVEL` | `info` | Frontend minimum log level |
+| `DEBUG` | `0` | Enable frontend debug logging (console + server) |
+
+### Using the Logger
+
+**Backend** (`server/lib/logger.ts`):
+```typescript
+import { log } from '../lib/logger'
+
+log.pty.info('Restored terminal', { terminalId: id, name })
+log.ws.error('Connection failed', { error: String(err) })
+```
+
+**Frontend** (`src/lib/logger.ts`):
+```typescript
+import { log } from '@/lib/logger'
+
+log.taskTerminal.debug('cwd changed', { cwd })
+log.ws.info('terminal:created', { terminalId, isNew: true })
+```
+
+### Searching Logs
+
+```bash
+# Find all errors
+grep '"lvl":"error"' ~/.vibora/vibora.log
+
+# Find logs for specific terminal
+grep '"terminalId":"abc-123"' ~/.vibora/vibora.log
+
+# Find PTYManager issues
+grep '"src":"PTYManager"' ~/.vibora/vibora.log
+
+# Pretty print with jq
+cat ~/.vibora/vibora.log | jq 'select(.lvl == "error")'
+```
+
+### Debug Build
+
+Build with debug logging enabled:
+```bash
+mise run desktop:package-dmg:debug  # DMG with debug logging
+mise run build:debug                # Web build with debug logging
+```
+
 ### Development vs Production
 
 The `mise run dev` command defaults to `~/.vibora/dev` (port 3222) to keep development data separate from production:
 
@@ -14,17 +14,36 @@ 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
 ```
 
 This installs vibora, the Claude Code plugin, and starts the server.
 
-### Install via npm
+#### Install via npm
 
 ```bash
 npx vibora@latest up
@@ -37,16 +56,40 @@ claude plugin marketplace add knowsuchagency/vibora
 claude plugin install vibora@vibora --scope user
 ```
 
-### Server Commands
+Open http://localhost:3333 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:3333`
+   - Enter credentials when prompted
+
+3. **Or access via browser:**
+   Open `http://your-server.example.com:3333`
+
+### Server Commands (Web Application)
 
 ```bash
 vibora up       # Start server daemon
 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:
@@ -59,7 +102,7 @@ Settings are stored in `.vibora/settings.json`. The vibora directory is resolved
 |---------|---------|---------|
 | port | `PORT` | 3333 |
 | 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 |
@@ -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.
Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,7 @@`
`8`	`8`	`"name": "vibora",`
`9`	`9`	`"source": "./plugins/vibora",`
`10`	`10`	`"description": "Task orchestration for Claude Code",`
`11`		`- "version": "1.15.0"`
	`11`	`+ "version": "2.0.0"`
`12`	`12`	`}`
`13`	`13`	`]`
`14`	`14`	`}`