vibelet 0.1.13 → 0.1.15

package/README.md

@@ -1,10 +1,12 @@
 # Vibelet
 
-`@vibelet/cli` is a macOS CLI that installs and manages the Vibelet daemon for remote coding sessions. The same package is also published as `vibelet`.
+`@vibelet/cli` is a cross-platform CLI that installs and manages the Vibelet daemon for remote coding sessions. The same package is also published as `vibelet`.
+
+Official website: https://vibelet.icu
 
 ## Requirements
 
-- macOS
+- macOS / Linux / Windows
 - Node.js 18 or newer
 
 ## Install
@@ -22,15 +24,29 @@ npm install -g vibelet
 vibelet
 ```
 
+The CLI prints the official website on each run so users can always jump back to the main docs and download page.
+
 ## Commands
 
 ```bash
-vibelet
-vibelet status
-vibelet logs
-vibelet reset
-vibelet --help
-vibelet --version
+vibelet              # Install/start daemon and print pairing QR code
+vibelet start        # Same as above
+vibelet stop         # Stop the daemon
+vibelet restart      # Restart the daemon
+vibelet status       # Show service and daemon status
+vibelet logs         # Print recent daemon logs
+vibelet reset        # Reset pairings and print a fresh QR code
+vibelet --help       # Show help
+vibelet --version    # Show CLI version
+```
+
+## Options
+
+```bash
+vibelet --relay <url>                  # Use a tunnel URL for remote access
+vibelet --relay ""                     # Clear saved relay URL
+vibelet --host <ip>                    # Set primary host/IP advertised for connections
+vibelet --fallback-hosts <ip1>,<ip2>   # Comma-separated fallback IPs
 ```
 
 ## Release
@@ -47,4 +63,14 @@ The dual publish script builds once, then publishes the same CLI bundle to both
 - The npm package publishes the CLI plus a minified daemon runtime bundle.
 - The package is intended for end users of the macOS host daemon, not for importing as a library.
 - The daemon keeps `~/.vibelet/data/audit.jsonl` and `~/.vibelet/logs/daemon.*.log` size-bounded by trimming the oldest content in place.
-- Optional env vars: `VIBE_AUDIT_MAX_BYTES`, `VIBE_DAEMON_LOG_MAX_BYTES`, `VIBE_STORAGE_HOUSEKEEPING_INTERVAL_MS`.
+- Environment variables:
+  | Variable | Default | Description |
+  |----------|---------|-------------|
+  | `VIBE_PORT` | `9876` | Daemon listen port |
+  | `VIBE_IDLE_TIMEOUT_MS` | `1800000` (30 min) | Idle timeout before a driver is released (0 = disabled) |
+  | `VIBE_TURN_STALL_TIMEOUT_MS` | `300000` (5 min) | Max inactivity for an in-flight turn (0 = disabled) |
+  | `VIBE_AUDIT_MAX_BYTES` | `8388608` (8 MB) | Max audit.jsonl size before trimming |
+  | `VIBE_DAEMON_LOG_MAX_BYTES` | `16777216` (16 MB) | Max daemon log file size before trimming |
+  | `VIBE_STORAGE_HOUSEKEEPING_INTERVAL_MS` | `300000` (5 min) | Log trimming check interval |
+  | `CLAUDE_PATH` | auto-detect | Path to Claude binary |
+  | `CODEX_PATH` | auto-detect | Path to Codex binary |

package/bin/vibelet.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import { spawn, spawnSync } from 'node:child_process';
-import { cpSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, openSync } from 'node:fs';
+import { cpSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, openSync, writeSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -25,6 +25,19 @@ const stdoutLogPath = join(logDir, 'daemon.stdout.log');
 const stderrLogPath = join(logDir, 'daemon.stderr.log');
 const pidFilePath = join(vibeletDir, 'daemon.pid');
 const relayConfigPath = join(vibeletDir, 'relay.json');
+const OFFICIAL_SITE_URL = 'https://vibelet.icu';
+
+let officialSitePrinted = false;
+
+function printOfficialSite() {
+  if (officialSitePrinted) return;
+  officialSitePrinted = true;
+  try {
+    writeSync(1, `\nOfficial site: ${OFFICIAL_SITE_URL}\n`);
+  } catch {
+    // Best-effort branding footer; ignore broken pipes and closed stdio.
+  }
+}
 
 // ─── Helpers ────────────────────────────────────────────────────────────────────
 
@@ -700,5 +713,6 @@ async function main() {
 
 process.on('SIGINT', () => process.exit(0));
 process.on('SIGTERM', () => process.exit(0));
+process.on('exit', printOfficialSite);
 await main();
 process.exit(0);