slashvibe-mcp 0.3.25 → 0.3.27

package/README.md

@@ -1,276 +1,83 @@
-# /vibe MCP Server
+# vibe-mcp
 
-[![npm version](https://img.shields.io/npm/v/slashvibe-mcp.svg)](https://www.npmjs.com/package/slashvibe-mcp)
-[![npm downloads](https://img.shields.io/npm/dw/slashvibe-mcp.svg)](https://www.npmjs.com/package/slashvibe-mcp)
-[![CI](https://github.com/VibeCodingInc/vibe-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/VibeCodingInc/vibe-mcp/actions/workflows/ci.yml)
-[![license](https://img.shields.io/npm/l/slashvibe-mcp.svg)](./LICENSE)
-[![node](https://img.shields.io/node/v/slashvibe-mcp.svg)](https://nodejs.org)
-[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)
-[![Smithery](https://smithery.ai/badge/slashvibe-mcp)](https://smithery.ai/server/slashvibe-mcp)
+Social layer for AI-assisted coding. DMs, presence, and connection between developers.
 
-The presence layer for AI-mediated work. See who's building, message them, share context — without leaving your editor.
+**Works in:** Claude Code • Cursor • Any MCP-compatible IDE
 
-**New:** Live buddy list widget renders inline in Claude Desktop and VS Code via [MCP Apps](https://modelcontextprotocol.io/docs/extensions/apps).
-
-Works with Claude Code, Cursor, VS Code, Windsurf, Cline, Continue.dev, JetBrains, and any MCP-compatible client.
-
-## Install
-
-**Quick install** — auto-detects your editors and configures all of them:
+## Quick Start
 
+**Claude Code:**
 ```bash
-npx slashvibe-mcp install
+npx slashvibe-mcp setup
 ```
 
-**Or** add to your MCP config manually and restart your editor:
+**Cursor:** See [Cursor Setup Guide](docs/CURSOR_SETUP.md)
 
-<details open>
-<summary><strong>Claude Code</strong></summary>
-
-```bash
-claude mcp add vibe -- npx -y slashvibe-mcp
-```
+**Other IDEs:** Any editor supporting MCP protocol can use the manual config below.
 
-Or add to `~/.claude.json`:
-```json
-{
-  "mcpServers": {
-    "vibe": {
-      "command": "npx",
-      "args": ["-y", "slashvibe-mcp"]
-    }
-  }
-}
-```
-</details>
+## Installation
 
-<details>
-<summary><strong>Cursor</strong></summary>
+```bash
+# Install globally
+npm install -g vibe-mcp
 
-Add to `~/.cursor/mcp.json`:
-```json
-{
-  "mcpServers": {
-    "vibe": {
-      "command": "npx",
-      "args": ["-y", "slashvibe-mcp"]
-    }
-  }
-}
+# Or add to Claude Code MCP config
+claude mcp add vibe-mcp
 ```
-</details>
-
-<details>
-<summary><strong>VS Code (GitHub Copilot)</strong></summary>
 
-Add to `.vscode/mcp.json` in your workspace:
-```json
-{
-  "servers": {
-    "vibe": {
-      "command": "npx",
-      "args": ["-y", "slashvibe-mcp"]
-    }
-  }
-}
-```
-</details>
+## Manual Setup
 
-<details>
-<summary><strong>Windsurf</strong></summary>
+Add to `~/.claude.json`:
 
-Add to `~/.codeium/windsurf/mcp_config.json`:
 ```json
 {
   "mcpServers": {
     "vibe": {
       "command": "npx",
-      "args": ["-y", "slashvibe-mcp"]
+      "args": ["vibe-mcp"],
+      "env": {
+        "VIBE_API_URL": "https://www.slashvibe.dev"
+      }
     }
   }
 }
 ```
-</details>
 
-<details>
-<summary><strong>Cline / Continue.dev / JetBrains</strong></summary>
+## Features
 
-**Cline:** Open MCP Servers > Configure > Edit JSON, add `vibe` server as above.
-
-**Continue.dev:** Create `.continue/mcpServers/vibe.json`:
-```json
-{
-  "command": "npx",
-  "args": ["-y", "slashvibe-mcp"]
-}
-```
+- **Presence** - See who's online building with Claude Code
+- **DMs** - Direct messages between developers
+- **Memory** - Remember context about connections
+- **Status** - Share what you're working on
+- **Games** - Play tic-tac-toe while coding
 
-**JetBrains:** Settings > Tools > AI Assistant > MCP, add server with command `npx` and args `-y slashvibe-mcp`.
-</details>
+## Commands
 
-## Getting Started
+Once installed, use these in Claude Code:
 
-Once installed, tell your AI:
+| Command | Description |
+|---------|-------------|
+| `vibe` | Check inbox and see who's online |
+| `vibe who` | List online users |
+| `vibe dm @handle "message"` | Send a DM |
+| `vibe status shipping` | Set your status |
+| `vibe remember @handle "note"` | Save a memory |
+| `vibe recall @handle` | Recall memories |
 
-```
-"let's vibe"
-```
+## API
 
-That's it. It authenticates you via GitHub, shows who's online, and checks your inbox.
+The MCP server connects to `slashvibe.dev` for:
+- User presence and discovery
+- Message routing
+- Identity verification
 
-Step-by-step:
+## Related
 
-1. **Authenticate** — `vibe init` opens GitHub OAuth. Takes 30 seconds.
-2. **See who's around** — `vibe who` shows online builders and what they're working on.
-3. **Check messages** — `vibe inbox` shows unread DMs.
-4. **Send a message** — `vibe dm @seth hey, just set up /vibe!`
-
-## Tools
-
-### Presence
-
-| Tool | What it does |
-|------|-------------|
-| `vibe_who` | See who's online and what they're building |
-| `vibe_status` | Set your mood or what you're working on |
-| `vibe_away` | Set yourself away with a message |
-| `vibe_back` | Return from away |
-| `vibe_presence_agent` | Background presence agent |
-
-### Messaging
-
-| Tool | What it does |
-|------|-------------|
-| `vibe_dm` | Send a direct message |
-| `vibe_inbox` | Check your unread messages |
-| `vibe_ping` | Send a quick wave to someone |
-| `vibe_react` | React to a message |
-| `vibe_open` | Open a conversation thread |
-| `vibe_follow` | Follow someone for notifications |
-| `vibe_unfollow` | Unfollow someone |
-
-### Sessions & Context
-
-| Tool | What it does |
-|------|-------------|
-| `vibe_start` | Entry point — authenticates, shows presence, checks inbox |
-| `vibe_bye` | End your session |
-| `vibe_context` | Share what you're working on |
-| `vibe_summarize` | Generate session summary from local journal |
-| `vibe_session_resume` | Resume context from a prior session |
-| `vibe_session_save` | Save your session — replayable, discoverable, forkable |
-| `vibe_session_fork` | Fork an existing session to build on it |
-| `vibe_handoff` | Hand off a task with full context |
-
-### Discovery & Memory
-
-| Tool | What it does |
-|------|-------------|
-| `vibe_discover` | Find people, skills, and collaborators |
-| `vibe_invite` | Generate an invite link |
-| `vibe_remember` | Save a note about someone |
-| `vibe_recall` | Pull up everything you know about someone |
-| `vibe_forget` | Delete a memory |
-
-### Collaboration
-
-| Tool | What it does |
-|------|-------------|
-| `vibe_ship` | Share what you shipped, an idea, or a request |
-| `vibe_feed` | See what people are shipping |
-| `vibe_reserve` | Reserve files for editing (prevents conflicts) |
-| `vibe_release` | Release file reservations |
-| `vibe_reservations` | List active reservations |
-| `vibe_create_artifact` | Create a shareable guide or workspace |
-| `vibe_view_artifact` | View shared artifacts |
-
-### Infrastructure
-
-| Tool | What it does |
-|------|-------------|
-| `vibe_init` | Set up identity via GitHub OAuth |
-| `vibe_help` | Show available commands |
-| `vibe_doctor` | Health check — API, auth, storage, presence |
-| `vibe_update` | Check for and apply updates |
-| `vibe_settings` | Configure preferences |
-| `vibe_notifications` | Configure notification channels |
-| `vibe_mute` | Mute a user |
-| `vibe_report` | Report issues or inappropriate behavior |
-
-## How It Works
-
-```
-Your Editor ←→ /vibe MCP (stdio) ←→ slashvibe.dev API ←→ Other users
-                     ↕
-               Local SQLite DB
-               (~/.vibecodings/sessions.db)
-```
-
-- **Presence** broadcasts via heartbeat — others see you in real time
-- **Messages** are stored locally first, then synced (optimistic send)
-- **Sessions** are journaled to SQLite — durable, resumable, summarizable
-- **Identity** persists via GitHub OAuth — your handle follows you across editors and machines
-- **Memory** is local — notes about people stay on your machine
-
-## Troubleshooting
-
-**"I installed but don't see /vibe tools"**
-- Restart your editor after adding the MCP config
-- Run `vibe doctor` to diagnose
-
-**"Authentication failed or timed out"**
-- OAuth opens a browser window — if it didn't, go to [slashvibe.dev/login](https://slashvibe.dev/login)
-- The callback runs on `localhost:9876` — make sure that port is free
-
-**"Messages aren't sending"**
-- Run `vibe doctor` to check API connectivity
-- Messages save locally even when offline — they sync on reconnect
-
-## Configuration
-
-Config: `~/.vibecodings/config.json` (primary) or `~/.vibe/config.json` (legacy fallback).
-
-Database: `~/.vibecodings/sessions.db` (SQLite, WAL mode).
-
-## Development
-
-```bash
-npm install
-npm test              # All tests
-npm run lint          # ESLint
-npm run typecheck     # TypeScript validation
-```
-
-```
-vibe-mcp/
-├── index.js          # MCP server entry + CLI
-├── config.js         # User identity
-├── presence.js       # Heartbeat loop (30s)
-├── analytics.js      # Anonymous usage tracking
-├── tools/            # MCP tools
-├── store/            # Persistence (api.js, sqlite.js, sessions.js)
-├── bridges/          # Platform integrations (Discord, Telegram, etc.)
-├── intelligence/     # Ambient signals (serendipity, proactive discovery)
-└── protocol/         # AIRC protocol
-```
-
-## Contributing
-
-We welcome contributions. See [CLA.md](./CLA.md) before submitting pull requests.
-
-- [GitHub Issues](https://github.com/VibeCodingInc/vibe-mcp/issues) — Bug reports
-- [Discussions](https://github.com/VibeCodingInc/vibe-mcp/discussions) — Feature proposals
+- [GitHub](https://github.com/VibeCodingInc/vibe-mcp) - Source code
+- [slashvibe.dev](https://slashvibe.dev) - Web presence
+- [Spirit Protocol](https://spiritprotocol.io) - Parent ecosystem
+- [AIRC](https://airc.chat) - Agent identity protocol
 
 ## License
 
-MIT — see [LICENSE](./LICENSE)
-
-## Links
-
-- [slashvibe.dev](https://slashvibe.dev) — Platform
-- [Vibe Terminal](https://github.com/VibeCodingInc/vibe-terminal) — Desktop app
-- [@slashvibe on X](https://twitter.com/slashvibe) — Updates
-
----
-
-Built by [Slash Vibe, Inc.](https://slashvibe.dev)
+MIT

package/analytics.js

@@ -97,35 +97,11 @@ function trackSession(event, sessionData = {}) {
   track(event === 'started' ? 'session_started' : 'session_ended', sessionData);
 }
 
-/**
- * Track editor install via universal installer
- * @param {string} editor - Editor name configured
- * @param {string} status - 'configured', 'exists', 'error'
- */
-function trackInstall(editor, status) {
-  track('editor_install', {
-    editor,
-    status,
-    platform: process.platform,
-    node: process.version
-  });
-}
-
-/**
- * Track tool usage distribution (called per tool invocation)
- * @param {string} toolName - Tool name (vibe_*)
- */
-function trackToolUsage(toolName) {
-  track('tool_call', { tool: toolName });
-}
-
 module.exports = {
   track,
   trackEmptyInbox,
   trackLurkMode,
   trackOnboardingTask,
   trackDiscovery,
-  trackSession,
-  trackInstall,
-  trackToolUsage
+  trackSession
 };

package/auth-store.js

@@ -0,0 +1,158 @@
+/**
+ * Auth Store - In-memory singleton for authentication state
+ *
+ * This is the SOURCE OF TRUTH for auth during MCP runtime.
+ * File persistence (config.json) is only for durability across restarts.
+ *
+ * Why this exists:
+ * - OAuth callback and API calls happen in the same MCP process
+ * - File-based auth was unreliable due to per-PID session files and caching
+ * - In-memory state is immediate and deterministic
+ *
+ * Usage:
+ * - Startup: authStore.hydrate() loads from disk once
+ * - OAuth: authStore.setToken(token) updates immediately
+ * - API calls: authStore.getToken() returns current token (no file I/O)
+ */
+
+// In-memory state - the single source of truth during runtime
+let _token = null;
+let _handle = null;
+let _oneLiner = null;
+let _hydrated = false;
+
+/**
+ * Hydrate auth state from disk (call once at MCP startup)
+ * This loads persisted state from config.json
+ */
+function hydrate() {
+  if (_hydrated) return; // Only hydrate once
+
+  try {
+    const config = require('./config');
+    const cfg = config.load();
+
+    _token = cfg.authToken || cfg.privyToken || null;
+    _handle = cfg.handle || cfg.username || null;
+    _oneLiner = cfg.one_liner || cfg.workingOn || null;
+
+    // Cross-client: if no token from config.json, check terminal/buddy auth.json
+    if (!_token) {
+      const terminalAuth = config.loadTerminalAuth();
+      if (terminalAuth?.token) {
+        _token = terminalAuth.token;
+        _handle = _handle || terminalAuth.handle || null;
+      }
+    }
+
+    _hydrated = true;
+
+    if (_token) {
+      console.error('[auth-store] Hydrated: @' + _handle);
+    } else {
+      console.error('[auth-store] Hydrated: no token');
+    }
+  } catch (e) {
+    console.error('[auth-store] Hydration failed:', e.message);
+  }
+}
+
+/**
+ * Set auth token (call after OAuth completes)
+ * @param {string} token - JWT token
+ */
+function setToken(token) {
+  const hadToken = !!_token;
+  _token = token;
+
+  if (!hadToken && token) {
+    console.error('[auth-store] Token set (was empty)');
+  } else if (hadToken && token && token !== _token) {
+    console.error('[auth-store] Token updated');
+  }
+}
+
+/**
+ * Get current auth token
+ * @returns {string|null} Current token or null
+ */
+function getToken() {
+  return _token;
+}
+
+/**
+ * Set user handle
+ * @param {string} handle - User handle (without @)
+ */
+function setHandle(handle) {
+  _handle = handle;
+}
+
+/**
+ * Get current handle
+ * @returns {string|null} Current handle or null
+ */
+function getHandle() {
+  return _handle;
+}
+
+/**
+ * Set one-liner (what user is building)
+ * @param {string} oneLiner - One-liner description
+ */
+function setOneLiner(oneLiner) {
+  _oneLiner = oneLiner;
+}
+
+/**
+ * Get current one-liner
+ * @returns {string|null} Current one-liner or null
+ */
+function getOneLiner() {
+  return _oneLiner;
+}
+
+/**
+ * Check if user is authenticated
+ * @returns {boolean} True if token exists
+ */
+function isAuthenticated() {
+  return !!_token;
+}
+
+/**
+ * Clear all auth state (for logout/reset)
+ */
+function clear() {
+  _token = null;
+  _handle = null;
+  _oneLiner = null;
+  console.error('[auth-store] Cleared');
+}
+
+/**
+ * Get full auth state (for debugging)
+ * @returns {object} Current auth state
+ */
+function getState() {
+  return {
+    token: _token ? _token.substring(0, 20) + '...' : null,
+    handle: _handle,
+    oneLiner: _oneLiner,
+    hydrated: _hydrated,
+    isAuthenticated: !!_token
+  };
+}
+
+module.exports = {
+  hydrate,
+  setToken,
+  getToken,
+  setHandle,
+  getHandle,
+  setOneLiner,
+  getOneLiner,
+  isAuthenticated,
+  clear,
+  getState
+};

package/auto-update.js

@@ -3,16 +3,14 @@
  * Checks for updates and prompts user to update
  */
 
-import { exec } from 'child_process';
-import { promisify } from 'util';
-import fs from 'fs/promises';
-import path from 'path';
-import { fileURLToPath } from 'url';
+const { exec } = require('child_process');
+const { promisify } = require('util');
+const fs = require('fs').promises;
+const path = require('path');
 
 const execAsync = promisify(exec);
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
-export async function checkForUpdates() {
+async function checkForUpdates() {
   try {
     // Read local version
     const versionPath = path.join(__dirname, 'version.json');
@@ -47,7 +45,7 @@ export async function checkForUpdates() {
   }
 }
 
-export async function performUpdate() {
+async function performUpdate() {
   try {
     const repoPath = path.join(__dirname, '..');
 
@@ -84,7 +82,7 @@ export async function performUpdate() {
   }
 }
 
-export function compareVersions(v1, v2) {
+function compareVersions(v1, v2) {
   const parts1 = v1.split('.').map(Number);
   const parts2 = v2.split('.').map(Number);
 
@@ -96,7 +94,7 @@ export function compareVersions(v1, v2) {
   return 0;
 }
 
-export function formatUpdateNotification(update) {
+function formatUpdateNotification(update) {
   if (!update) return null;
 
   let message = `\n${'='.repeat(60)}\n`;
@@ -123,3 +121,10 @@ export function formatUpdateNotification(update) {
 
   return message;
 }
+
+module.exports = {
+  checkForUpdates,
+  performUpdate,
+  compareVersions,
+  formatUpdateNotification
+};