slashvibe-mcp 0.3.19 → 0.3.20

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Slash Vibe, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,70 +1,288 @@
-# vibe-mcp
+# /vibe MCP Server
 
-Social layer for Claude Code. DMs, presence, and connection between AI-assisted developers.
+The social layer for AI coding. DMs, presence, discovery, and games between developers — without leaving your editor.
 
-## Installation
+Works with Claude Code, Cursor, VS Code, Windsurf, Cline, Continue.dev, JetBrains, and any MCP-compatible client.
 
-```bash
-# Install globally
-npm install -g vibe-mcp
+## Install
 
-# Or add to Claude Code MCP config
-claude mcp add vibe-mcp
-```
+Add to your MCP config and restart your editor:
 
-## Manual Setup
+<details open>
+<summary><strong>Claude Code</strong></summary>
 
 Add to `~/.claude.json`:
+```json
+{
+  "mcpServers": {
+    "vibe": {
+      "command": "npx",
+      "args": ["-y", "slashvibe-mcp"]
+    }
+  }
+}
+```
 
+Or via CLI:
+```bash
+claude mcp add vibe -- npx -y slashvibe-mcp
+```
+</details>
+
+<details>
+<summary><strong>Cursor</strong></summary>
+
+Add to `~/.cursor/mcp.json`:
 ```json
 {
   "mcpServers": {
     "vibe": {
       "command": "npx",
-      "args": ["vibe-mcp"],
-      "env": {
-        "VIBE_API_URL": "https://www.slashvibe.dev"
+      "args": ["-y", "slashvibe-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"]
+    }
+  }
+}
+```
+
+Or add to your `settings.json`:
+```json
+{
+  "mcp": {
+    "servers": {
+      "vibe": {
+        "command": "npx",
+        "args": ["-y", "slashvibe-mcp"]
       }
     }
   }
 }
 ```
+</details>
+
+<details>
+<summary><strong>Windsurf</strong></summary>
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+```json
+{
+  "mcpServers": {
+    "vibe": {
+      "command": "npx",
+      "args": ["-y", "slashvibe-mcp"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Cline (VS Code)</strong></summary>
+
+Open Cline > MCP Servers icon > Configure > Edit JSON, then add:
+```json
+{
+  "mcpServers": {
+    "vibe": {
+      "command": "npx",
+      "args": ["-y", "slashvibe-mcp"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Continue.dev</strong></summary>
+
+Create `.continue/mcpServers/vibe.json`:
+```json
+{
+  "command": "npx",
+  "args": ["-y", "slashvibe-mcp"]
+}
+```
+</details>
+
+<details>
+<summary><strong>JetBrains (IntelliJ, WebStorm, etc.)</strong></summary>
+
+Go to **Settings > Tools > AI Assistant > Model Context Protocol (MCP)** and add a new server:
+- **Command:** `npx`
+- **Arguments:** `-y slashvibe-mcp`
+
+Or import from your Claude Code config if you already have one.
+</details>
+
+## Getting Started
+
+Once installed, tell Claude:
+
+```
+"let's vibe"
+```
+
+That's it. Claude will authenticate you via GitHub, show who's online, and check your inbox.
+
+If you prefer step-by-step:
+
+1. **Authenticate** — `vibe init` opens GitHub OAuth in your browser. 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 your first message** — `vibe dm @seth hey, just set up /vibe!`
+
+## Tools
+
+### Core — Messaging & Presence
+
+| Tool | What it does |
+|------|-------------|
+| `vibe_start` | Entry point — authenticates, shows who's online, checks inbox |
+| `vibe_init` | Set up your identity via GitHub OAuth |
+| `vibe_who` | See who's online and what they're building |
+| `vibe_dm` | Send a direct message |
+| `vibe_inbox` | Check your unread messages |
+| `vibe_open` | Open a conversation thread with someone |
+| `vibe_ping` | Send a quick wave to someone |
+| `vibe_react` | React to a message |
+| `vibe_status` | Set your mood or what you're working on |
+| `vibe_away` / `vibe_back` | Set yourself away or return |
+| `vibe_bye` | End your session |
 
-## Features
+### Discovery — Find Your People
 
-- **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
+| Tool | What it does |
+|------|-------------|
+| `vibe_discover` | Find builders by interests, projects, or activity |
+| `vibe_suggest_tags` | Get tag suggestions for your profile |
+| `vibe_skills_exchange` | Browse and offer skills |
+| `vibe_workshop_buddy` | Find a learning partner |
+| `vibe_invite` | Generate an invite link |
 
-## Commands
+### Creative — Ship & Share
 
-Once installed, use these in Claude Code:
+| Tool | What it does |
+|------|-------------|
+| `vibe_ship` | Announce what you shipped |
+| `vibe_idea` | Share an idea with the community |
+| `vibe_request` | Ask the community for help |
+| `vibe_feed` | See what people are shipping and sharing |
+| `vibe_create_artifact` | Create a shareable guide, workspace, or learning |
+| `vibe_view_artifact` | View shared artifacts |
 
-| 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 |
+### Memory — Context That Persists
 
-## API
+| Tool | What it does |
+|------|-------------|
+| `vibe_remember` | Save a note about someone for next time |
+| `vibe_recall` | Pull up everything you know about someone |
+| `vibe_forget` | Delete a memory |
+| `vibe_handoff` | Create an AIRC context handoff for another tool |
 
-The MCP server connects to `slashvibe.dev` for:
-- User presence and discovery
-- Message routing
-- Identity verification
+### Games — 27 Multiplayer & Solo Games
 
-## Related
+| Tool | What it does |
+|------|-------------|
+| `vibe_game` | Start a multiplayer game with someone |
+| `vibe_solo_game` | Play a solo game (riddles, hangman, number guess) |
+| `vibe_tictactoe` | Challenge someone to tic-tac-toe |
+| `vibe_crossword` | Collaborative crossword puzzle |
+| `vibe_drawing` | Collaborative ASCII drawing |
+| `vibe_party_game` | Start a party game for 3+ players |
 
-- [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
+### Bridges — Cross-Platform Social
+
+| Tool | What it does |
+|------|-------------|
+| `vibe_x_mentions` | Check your X/Twitter mentions |
+| `vibe_x_reply` | Reply on X from the terminal |
+| `vibe_social_inbox` | Unified inbox across platforms |
+| `vibe_social_post` | Post to multiple networks at once |
+
+### Diagnostics
+
+| Tool | What it does |
+|------|-------------|
+| `vibe_doctor` | Full health check — API, auth, storage, presence |
+| `vibe_test` | Quick connection and identity test |
+| `vibe_help` | Show available commands |
+| `vibe_update` | Check for and apply updates |
+| `vibe_settings` | Configure preferences |
+
+## How It Works
+
+/vibe is an MCP server that connects your editor to [slashvibe.dev](https://slashvibe.dev). Messages sync via a Postgres backend with local SQLite persistence for offline-first speed. Everyone using /vibe is on the same network — regardless of which editor they use.
+
+```
+Your Editor ←→ /vibe MCP (stdio) ←→ slashvibe.dev API ←→ Other users
+                     ↕
+               Local SQLite DB
+               (~/.vibecodings/sessions.db)
+```
+
+- **Identity** persists via GitHub OAuth — your handle follows you across sessions
+- **Messages** are stored locally first, then synced to the server (optimistic send)
+- **Presence** broadcasts via heartbeat — others see you in real time
+- **Memory** is local — notes you save about people stay on your machine
+
+## Troubleshooting
+
+**"I installed but don't see /vibe tools in Claude Code"**
+- Make sure you restarted Claude Code after adding the MCP config
+- Check your config file: `~/.claude.json` or `~/.config/claude-code/mcp.json`
+- Run `vibe doctor` to diagnose issues
+
+**"Authentication failed or timed out"**
+- The OAuth flow opens a browser window — if it didn't open, go to [slashvibe.dev/login](https://slashvibe.dev/login) manually
+- The auth callback runs on `localhost:9876` — make sure that port is free
+- You have 2 minutes to complete the GitHub login
+
+**"Messages aren't sending"**
+- Run `vibe doctor` to check API connectivity
+- Check your internet connection
+- Messages are saved locally even if the API is down — they'll sync when you reconnect
+
+**"I see 'Unknown tool' errors"**
+- You may be running an older version. Run `vibe update` or reinstall: `npm install -g slashvibe-mcp`
+
+## Configuration
+
+Config lives at `~/.vibecodings/config.json` (primary) or `~/.vibe/config.json` (legacy fallback).
+
+Local message database: `~/.vibecodings/sessions.db` (SQLite, shared with Vibe Terminal desktop app).
+
+## Contributing
+
+We welcome contributions. Please read our [Contributor License Agreement](./CLA.md) before submitting pull requests.
+
+- Report bugs via [GitHub Issues](https://github.com/VibeCodingInc/vibe-mcp/issues)
+- Propose features via [Discussions](https://github.com/VibeCodingInc/vibe-mcp/discussions)
 
 ## License
 
-MIT
+MIT — see [LICENSE](./LICENSE)
+
+## Links
+
+- [slashvibe.dev](https://slashvibe.dev) — The 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)

package/config.js

@@ -72,8 +72,8 @@ function save(config) {
     // GitHub Activity settings
     github_activity_enabled: config.github_activity_enabled !== undefined ? config.github_activity_enabled : existing.github_activity_enabled,
     github_activity_privacy: config.github_activity_privacy || existing.github_activity_privacy || null,
-    // OAuth token (persisted across MCP process restarts)
-    authToken: config.authToken || config.privyToken || existing.authToken || existing.privyToken || null,
+    // Privy OAuth token (persisted across MCP process restarts)
+    privyToken: config.privyToken || existing.privyToken || null,
     authMethod: config.authMethod || existing.authMethod || null
   };
   fs.writeFileSync(PRIMARY_CONFIG, JSON.stringify(data, null, 2));
@@ -217,52 +217,43 @@ function getAuthToken() {
 
   // Fall back to shared config (persisted across MCP process restarts)
   const cfg = load();
-  return cfg?.authToken || cfg?.privyToken || null;
+  return cfg?.privyToken || null;
 }
 
 /**
- * Save auth token (used after browser OAuth flow)
- * @param {string} token - JWT access token from GitHub OAuth
+ * Save Privy JWT token (used after browser OAuth flow)
+ * @param {string} token - Privy access token
  */
-function saveAuthToken(token) {
+function savePrivyToken(token) {
   // Save to session data
   const data = getSessionData() || {};
   saveSessionData({
     ...data,
     sessionId: data.sessionId || generateSessionId(),
     token,
-    authMethod: 'github'  // Track that this is GitHub OAuth
+    authMethod: 'privy'  // Track that this is a Privy token
   });
 
   // Also save to shared config for persistence across MCP restarts
   const cfg = load();
-  cfg.authToken = token;
-  cfg.authMethod = 'github';
+  cfg.privyToken = token;
+  cfg.authMethod = 'privy';
   save(cfg);
 }
 
-// Backwards compatibility alias
-const savePrivyToken = saveAuthToken;
-
 /**
- * Check if user has OAuth auth (vs legacy keypair)
- * Accepts 'github', 'privy', and 'browser' as valid auth methods (backwards compat)
+ * Check if user has Privy auth (vs legacy keypair)
  */
-function hasOAuth() {
-  const validAuthMethods = ['github', 'privy', 'browser'];
-
+function hasPrivyAuth() {
   const data = getSessionData();
-  if (validAuthMethods.includes(data?.authMethod) && data?.token) return true;
+  if (data?.authMethod === 'privy' && data?.token) return true;
 
   const cfg = load();
-  return validAuthMethods.includes(cfg?.authMethod) && (cfg?.authToken || cfg?.privyToken);
+  return cfg?.authMethod === 'privy' && cfg?.privyToken;
 }
 
-// Backwards compatibility alias
-const hasPrivyAuth = hasOAuth;
-
 /**
- * Remove keypair after migration to GitHub OAuth
+ * Remove keypair after migration to Privy
  * Clears private key from config (security improvement)
  */
 function removeKeypair() {
@@ -418,10 +409,7 @@ module.exports = {
   getGithubActivityPrivacy,
   setGithubActivityPrivacy,
   getApiUrl,
-  // OAuth helpers
-  saveAuthToken,
-  hasOAuth,
-  // Backwards compatibility aliases
+  // Privy OAuth helpers
   savePrivyToken,
   hasPrivyAuth,
   removeKeypair,