vibepulse 0.1.0

package/README.md

@@ -0,0 +1,148 @@
+# VibePulse
+
+Real-time dashboard for monitoring and managing OpenCode sessions.
+
+![VibePulse README cover](./public/readme-cover.png)
+
+## Features
+
+### Session Management
+- **Real-time sync** — Automatically syncs OpenCode sessions via SSE + polling
+- **4-column board** — Idle, Busy, Review, Done
+- **Drag & drop** — Reorder cards within columns
+- **IDE integration** — Click to open workspace in VSCode / Antigravity
+- **Audio notifications** — Sound alerts when sessions complete or need attention
+- **Process hints** — Detects OpenCode processes without exposed API ports
+- **Offline snapshot** — Displays last known state when OpenCode is unreachable
+- **Auto-generated cards** — No manual card creation needed
+
+### Configuration Management (New)
+- **Profile System** — Create and manage multiple configuration profiles for different workflows
+  - Built-in profiles (e.g., "Balanced") with optimized agent/category configurations
+  - Custom profiles with user-defined settings
+  - One-click profile switching
+  - **Reset to Profile** — After applying a profile, if you modify configs elsewhere, click "Reset" to restore the profile's original values (with confirmation dialog)
+- **Agent Configuration** — Configure models, temperature, and other parameters for each agent (sisyphus, oracle, librarian, etc.)
+- **Category Configuration** — Set up model preferences for different task categories (visual-engineering, ultrabrain, deep, quick, etc.)
+- **Model Selector** — Smart model selection with grouped providers and search; shows error state with retry button if model fetch fails
+
+## Tech Stack
+
+- Next.js (App Router)
+- TypeScript
+- Tailwind CSS
+- @dnd-kit (drag and drop)
+- TanStack Query (state management)
+- @opencode-ai/sdk
+
+## Getting Started
+
+### Quick Start (npx)
+
+```bash
+# Run directly without installing
+npx vibepulse
+
+# Or specify a custom port
+PORT=8080 npx vibepulse
+```
+
+Open [http://localhost:3456](http://localhost:3456)
+
+### Development
+
+```bash
+# Install dependencies
+npm install
+
+# Make sure OpenCode is running locally, then:
+npm run dev
+
+# Or specify a custom port
+PORT=8080 npm run dev
+```
+
+Open [http://localhost:3456](http://localhost:3456) (default port: 3456)
+
+## Architecture
+
+```
+┌─────────────┐     ┌─────────────┐     ┌─────────────┐
+│   Browser   │────▶│  Next.js    │────▶│  OpenCode   │
+│             │◀────│    API      │◀────│    SDK      │
+└─────────────┘     └─────────────┘     └─────────────┘
+       │                   │
+       └───────────────────┘
+          SSE Events (real-time)
+```
+
+📖 **Session Status Detection**: See [docs/session-status-detection.md](./docs/session-status-detection.md) for detailed explanation of how session statuses are detected, including the sticky state mechanism and detection limitations.
+
+## How It Works
+
+### Session Management
+1. Discovers OpenCode instances via port scanning and process detection
+2. Fetches sessions from OpenCode SDK with 5-second polling
+3. SSE connection provides real-time updates for immediate feedback
+4. Multi-layer status detection (see [docs/session-status-detection.md](./docs/session-status-detection.md)):
+   - Analyzes message part states (running/completed/waiting)
+   - Applies sticky state buffering to prevent flickering
+   - Cascades child session status to parent sessions
+5. Cards are auto-generated and organized into kanban columns
+
+### Configuration Management
+1. **Profiles** are stored in `~/.config/opencode/profiles/`
+2. **Applying a Profile** overwrites your current agent and category configurations
+3. **Reset Functionality** — When a profile shows "Reset" button:
+   - The profile was previously applied but configs have been modified
+   - Click "Reset" and confirm to restore the profile's original values
+4. **Model Fetching** — Models are fetched from `opencode models` CLI command; if it fails, an error state is shown with a retry button (no fallback models)
+
+## Troubleshooting
+
+### Configuration Management
+
+#### Models not loading / "Failed to fetch models" error
+- Ensure `opencode` CLI is installed and available in your PATH
+- Check that `~/.opencode/bin` is in your PATH
+- Click the **Retry** button in the model selector to attempt fetching again
+- Run `opencode models` in your terminal to verify CLI is working
+
+#### Profile Reset not working
+- Make sure the profile was previously applied (shows "Reset" button instead of "Apply")
+- The reset requires confirmation — check that you clicked "Reset" in the confirmation dialog
+- If configs still don't reset, try re-applying the profile from the profile list
+
+#### Board shows "No sessions found"
+- Ensure OpenCode is running locally
+- Check that the SDK can connect (port conflicts)
+- Look for the ℹ️ icon in the header for process hints
+
+### Session status flickers or seems inaccurate
+- This is a known limitation due to sparse OpenCode status signals
+- See [docs/session-status-detection.md](./docs/session-status-detection.md) for detailed explanation
+- The board uses 25-second sticky buffering to reduce flickering
+
+### IDE doesn't open
+- Make sure VSCode / Antigravity is installed
+- Check that the corresponding protocol handler is registered (e.g. `vscode://`)
+
+### Prevent VSCode from replacing an existing window
+
+Open VSCode Settings (JSON) and add:
+
+```json
+"window.openFoldersInNewWindow": "on"
+```
+
+## Known Limitations
+
+- Single user only (no collaboration)
+- Card positions stored in LocalStorage only
+- Cannot focus specific IDE window (opens workspace)
+- No manual card creation/editing
+- Session status detection has inherent limitations (see [docs/session-status-detection.md](./docs/session-status-detection.md))
+
+## License
+
+MIT

package/bin/vibepulse.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const port = process.env.PORT || '3456';
+
+console.log(`🚀 Starting VibePulse on port ${port}...`);
+console.log(`📊 Open http://localhost:${port} to view the dashboard`);
+console.log('');
+
+// Try to find next binary
+let nextBin;
+const possiblePaths = [
+  // Local development
+  path.join(__dirname, '..', 'node_modules', '.bin', 'next'),
+  // Global install
+  path.join(__dirname, '..', '..', '.bin', 'next'),
+];
+
+for (const p of possiblePaths) {
+  if (fs.existsSync(p)) {
+    nextBin = p;
+    break;
+  }
+}
+
+if (!nextBin) {
+  // Try using npx
+  nextBin = 'npx';
+}
+
+const args = nextBin === 'npx' 
+  ? ['next', 'dev', '-p', port]
+  : ['dev', '-p', port];
+
+const proc = spawn(nextBin, args, {
+  cwd: path.join(__dirname, '..'),
+  stdio: 'inherit',
+  env: {
+    ...process.env,
+    PORT: port
+  }
+});
+
+proc.on('error', (err) => {
+  console.error('Failed to start VibePulse:', err.message);
+  console.error('\nMake sure you have Next.js installed:');
+  console.error('  npm install next');
+  process.exit(1);
+});
+
+proc.on('exit', (code) => {
+  process.exit(code);
+});

package/dist/index.d.mts

@@ -0,0 +1,137 @@
+/**
+ * Agent configuration - defines how an agent behaves
+ * All fields are optional as configuration may be partial
+ */
+interface AgentConfig {
+    /** Model identifier (e.g., 'claude-3-5-sonnet-20241022') */
+    model?: string;
+    /** Sampling temperature (0-2) */
+    temperature?: number;
+    /** Top-p sampling parameter (0-1) */
+    top_p?: number;
+    /** Maximum tokens per response */
+    max_tokens?: number;
+    /** System prompt override for this agent */
+    system?: string;
+    /** Additional model-specific parameters */
+    [key: string]: unknown;
+}
+/**
+ * Category configuration - defines model settings for task categories
+ * Categories are used by task() to select appropriate models
+ * All fields are optional as configuration may be partial
+ */
+interface CategoryConfig {
+    /** Model identifier (e.g., 'google/gemini-3.1-pro') */
+    model?: string;
+    /** Model variant (e.g., 'max', 'high', 'medium', 'low', 'xhigh') */
+    variant?: string;
+    /** Sampling temperature (0-2) */
+    temperature?: number;
+    /** Top-p sampling parameter (0-1) */
+    top_p?: number;
+    /** Additional system prompt to append */
+    prompt_append?: string;
+    /** Human-readable description */
+    description?: string;
+}
+/**
+ * OhMyOpencode configuration
+ * Root configuration object for oh-my-opencode
+ * All fields are optional as configuration may be partial
+ */
+interface OhMyOpencodeConfig {
+    /** Global agent configurations keyed by agent name */
+    agents?: Record<string, AgentConfig>;
+    /** Category configurations for task type model selection */
+    categories?: Record<string, CategoryConfig>;
+    /** Default agent configuration to use as base */
+    defaultAgent?: AgentConfig;
+    /** Project-specific settings */
+    project?: {
+        /** Project name */
+        name?: string;
+        /** Working directory */
+        cwd?: string;
+    };
+    /** Runtime configuration */
+    runtime?: {
+        /** Enable/disable features */
+        features?: {
+            /** Enable auto-approval for safe operations */
+            autoApprove?: boolean;
+            /** Enable verbose logging */
+            verbose?: boolean;
+            /** Enable debug mode */
+            debug?: boolean;
+        };
+        /** Maximum retry attempts */
+        maxRetries?: number;
+        /** Request timeout in milliseconds */
+        timeout?: number;
+    };
+    /** Tool-specific configurations */
+    tools?: Record<string, unknown>;
+    /** Custom environment variables */
+    env?: Record<string, string>;
+    /** Additional custom configuration */
+    [key: string]: unknown;
+}
+/**
+ * Profile configuration - defines agent and category settings for a profile
+ * Profiles allow switching between different agent/category configurations
+ */
+interface ProfileConfig {
+    /** Agent configurations keyed by agent name */
+    agents: Record<string, AgentConfig>;
+    /** Category configurations for task type model selection */
+    categories?: Record<string, CategoryConfig>;
+}
+/**
+ * Profile - represents a named configuration profile
+ * Profiles can be built-in or user-created
+ */
+interface Profile {
+    /** Unique identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Emoji icon for display */
+    emoji: string;
+    /** Optional description */
+    description?: string;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+    /** Whether this is a default system profile */
+    isDefault?: boolean;
+    /** Whether this is a built-in profile that cannot be deleted */
+    isBuiltIn?: boolean;
+}
+/**
+ * Profile index - tracks all profiles and active selection
+ * This is the top-level structure for profile management
+ */
+interface ProfileIndex {
+    /** Schema version for migrations */
+    version: number;
+    /** All available profiles */
+    profiles: Profile[];
+    /** Currently active profile ID */
+    activeProfileId: string | null;
+    /** Last modification timestamp */
+    lastModified: string;
+}
+
+declare const CONFIG_DIR: string;
+declare const CONFIG_PATH: string;
+type OpenCodeConfig = {
+    agents?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+declare function detectConfig(configPath?: string): boolean;
+declare function readConfig(configPath?: string): Promise<OpenCodeConfig>;
+declare function writeConfig(config: OpenCodeConfig, configPath?: string): Promise<void>;
+
+export { type AgentConfig, CONFIG_DIR, CONFIG_PATH, type CategoryConfig, type OhMyOpencodeConfig, type OpenCodeConfig, type Profile, type ProfileConfig, type ProfileIndex, detectConfig, readConfig, writeConfig };

package/dist/index.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Agent configuration - defines how an agent behaves
+ * All fields are optional as configuration may be partial
+ */
+interface AgentConfig {
+    /** Model identifier (e.g., 'claude-3-5-sonnet-20241022') */
+    model?: string;
+    /** Sampling temperature (0-2) */
+    temperature?: number;
+    /** Top-p sampling parameter (0-1) */
+    top_p?: number;
+    /** Maximum tokens per response */
+    max_tokens?: number;
+    /** System prompt override for this agent */
+    system?: string;
+    /** Additional model-specific parameters */
+    [key: string]: unknown;
+}
+/**
+ * Category configuration - defines model settings for task categories
+ * Categories are used by task() to select appropriate models
+ * All fields are optional as configuration may be partial
+ */
+interface CategoryConfig {
+    /** Model identifier (e.g., 'google/gemini-3.1-pro') */
+    model?: string;
+    /** Model variant (e.g., 'max', 'high', 'medium', 'low', 'xhigh') */
+    variant?: string;
+    /** Sampling temperature (0-2) */
+    temperature?: number;
+    /** Top-p sampling parameter (0-1) */
+    top_p?: number;
+    /** Additional system prompt to append */
+    prompt_append?: string;
+    /** Human-readable description */
+    description?: string;
+}
+/**
+ * OhMyOpencode configuration
+ * Root configuration object for oh-my-opencode
+ * All fields are optional as configuration may be partial
+ */
+interface OhMyOpencodeConfig {
+    /** Global agent configurations keyed by agent name */
+    agents?: Record<string, AgentConfig>;
+    /** Category configurations for task type model selection */
+    categories?: Record<string, CategoryConfig>;
+    /** Default agent configuration to use as base */
+    defaultAgent?: AgentConfig;
+    /** Project-specific settings */
+    project?: {
+        /** Project name */
+        name?: string;
+        /** Working directory */
+        cwd?: string;
+    };
+    /** Runtime configuration */
+    runtime?: {
+        /** Enable/disable features */
+        features?: {
+            /** Enable auto-approval for safe operations */
+            autoApprove?: boolean;
+            /** Enable verbose logging */
+            verbose?: boolean;
+            /** Enable debug mode */
+            debug?: boolean;
+        };
+        /** Maximum retry attempts */
+        maxRetries?: number;
+        /** Request timeout in milliseconds */
+        timeout?: number;
+    };
+    /** Tool-specific configurations */
+    tools?: Record<string, unknown>;
+    /** Custom environment variables */
+    env?: Record<string, string>;
+    /** Additional custom configuration */
+    [key: string]: unknown;
+}
+/**
+ * Profile configuration - defines agent and category settings for a profile
+ * Profiles allow switching between different agent/category configurations
+ */
+interface ProfileConfig {
+    /** Agent configurations keyed by agent name */
+    agents: Record<string, AgentConfig>;
+    /** Category configurations for task type model selection */
+    categories?: Record<string, CategoryConfig>;
+}
+/**
+ * Profile - represents a named configuration profile
+ * Profiles can be built-in or user-created
+ */
+interface Profile {
+    /** Unique identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Emoji icon for display */
+    emoji: string;
+    /** Optional description */
+    description?: string;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+    /** Whether this is a default system profile */
+    isDefault?: boolean;
+    /** Whether this is a built-in profile that cannot be deleted */
+    isBuiltIn?: boolean;
+}
+/**
+ * Profile index - tracks all profiles and active selection
+ * This is the top-level structure for profile management
+ */
+interface ProfileIndex {
+    /** Schema version for migrations */
+    version: number;
+    /** All available profiles */
+    profiles: Profile[];
+    /** Currently active profile ID */
+    activeProfileId: string | null;
+    /** Last modification timestamp */
+    lastModified: string;
+}
+
+declare const CONFIG_DIR: string;
+declare const CONFIG_PATH: string;
+type OpenCodeConfig = {
+    agents?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+declare function detectConfig(configPath?: string): boolean;
+declare function readConfig(configPath?: string): Promise<OpenCodeConfig>;
+declare function writeConfig(config: OpenCodeConfig, configPath?: string): Promise<void>;
+
+export { type AgentConfig, CONFIG_DIR, CONFIG_PATH, type CategoryConfig, type OhMyOpencodeConfig, type OpenCodeConfig, type Profile, type ProfileConfig, type ProfileIndex, detectConfig, readConfig, writeConfig };

package/dist/index.js

@@ -0,0 +1,74 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CONFIG_DIR: () => CONFIG_DIR,
+  CONFIG_PATH: () => CONFIG_PATH,
+  detectConfig: () => detectConfig,
+  readConfig: () => readConfig,
+  writeConfig: () => writeConfig
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/lib/opencodeConfig.ts
+var import_promises = require("fs/promises");
+var import_fs = require("fs");
+var import_path = require("path");
+var import_os = require("os");
+var import_comment_json = require("comment-json");
+var CONFIG_DIR = (0, import_path.join)((0, import_os.homedir)(), ".config", "opencode");
+var CONFIG_PATH = (0, import_path.join)(CONFIG_DIR, "oh-my-opencode.json");
+function detectConfig(configPath = CONFIG_PATH) {
+  try {
+    return (0, import_fs.existsSync)(configPath);
+  } catch {
+    return false;
+  }
+}
+async function readConfig(configPath = CONFIG_PATH) {
+  try {
+    const content = await (0, import_promises.readFile)(configPath, "utf-8");
+    const config = (0, import_comment_json.parse)(content, null, false);
+    return config;
+  } catch (error) {
+    return {};
+  }
+}
+async function writeConfig(config, configPath = CONFIG_PATH) {
+  try {
+    const configDir = (0, import_path.join)(configPath, "..");
+    if (!(0, import_fs.existsSync)(configDir)) {
+      (0, import_fs.mkdirSync)(configDir, { recursive: true });
+    }
+    const content = (0, import_comment_json.stringify)(config, null, 2);
+    await (0, import_promises.writeFile)(configPath, content, "utf-8");
+  } catch (error) {
+    throw new Error(`Failed to write config: ${error}`);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CONFIG_DIR,
+  CONFIG_PATH,
+  detectConfig,
+  readConfig,
+  writeConfig
+});

package/dist/index.mjs

@@ -0,0 +1,43 @@
+// src/lib/opencodeConfig.ts
+import { readFile, writeFile } from "fs/promises";
+import { existsSync, mkdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { parse, stringify } from "comment-json";
+var CONFIG_DIR = join(homedir(), ".config", "opencode");
+var CONFIG_PATH = join(CONFIG_DIR, "oh-my-opencode.json");
+function detectConfig(configPath = CONFIG_PATH) {
+  try {
+    return existsSync(configPath);
+  } catch {
+    return false;
+  }
+}
+async function readConfig(configPath = CONFIG_PATH) {
+  try {
+    const content = await readFile(configPath, "utf-8");
+    const config = parse(content, null, false);
+    return config;
+  } catch (error) {
+    return {};
+  }
+}
+async function writeConfig(config, configPath = CONFIG_PATH) {
+  try {
+    const configDir = join(configPath, "..");
+    if (!existsSync(configDir)) {
+      mkdirSync(configDir, { recursive: true });
+    }
+    const content = stringify(config, null, 2);
+    await writeFile(configPath, content, "utf-8");
+  } catch (error) {
+    throw new Error(`Failed to write config: ${error}`);
+  }
+}
+export {
+  CONFIG_DIR,
+  CONFIG_PATH,
+  detectConfig,
+  readConfig,
+  writeConfig
+};

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "vibepulse",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Real-time dashboard for monitoring and managing OpenCode sessions",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChatTreeNet/VibePulse"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "dev": "next dev -p 3456",
+    "build": "next build",
+    "start": "next start -p 3456",
+    "lint": "eslint",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "build:lib": "tsup src/index.ts --format cjs,esm --dts --clean --outDir dist --external react,react-dom,next --tsconfig tsconfig.lib.json"
+  },
+  "bin": {
+    "vibepulse": "./bin/vibepulse.js"
+  },
+  "dependencies": {
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
+    "@opencode-ai/sdk": "^1.2.15",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-select": "^2.2.6",
+    "@radix-ui/react-tabs": "^1.1.13",
+    "@tanstack/react-query": "^5.90.21",
+    "clsx": "^2.1.1",
+    "comment-json": "^4.6.2",
+    "lucide-react": "^0.575.0",
+    "react-hook-form": "^7.71.2",
+    "tailwind-merge": "^3.5.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@vitejs/plugin-react": "^4.5.2",
+    "esbuild-plugin-alias": "^0.2.1",
+    "eslint": "^9",
+    "eslint-config-next": "16.1.6",
+    "jsdom": "^26.1.0",
+    "tailwindcss": "^4",
+    "tsup": "^8.5.1",
+    "typescript": "^5",
+    "vitest": "^3.2.4"
+  }
+}