VibeDeck

Files-First Personal Productivity Platform for VS Code

VibeDeck is a personal app platform that integrates with VS Code and AI assistants (Claude, Copilot) through MCP. All data is stored as simple JSON files in your project - no servers, no cloud, just files you own.

Features

• Files-First Architecture: All data stored as readable JSON files in .vibedeck/
• AI Integration: Works with Claude, Copilot, and any MCP-compatible AI
• VS Code Native: Runs as a VS Code extension with sidebar UI
• Built-in Apps: Finance tracker, Assistant (notes/todos), Calendar
• Zero Setup: Initialize in any project with one click

Quick Start

1. Install Extension

cd extension
npm install
npm run compile

In VS Code, press F5 to launch a new window with the extension.

2. Initialize VibeDeck

Open any folder in VS Code. VibeDeck will prompt you to initialize:

1. Click "Initialize VibeDeck"
2. Select which apps to install
3. Done! Your .vibedeck/ folder is ready

Or run command: VibeDeck: Initialize in Workspace

3. Use with AI

VibeDeck provides MCP tools that AI assistants can use:

You: "Add $50 expense for groceries"
AI: [uses finance_add_transaction tool]
UI: Automatically updates!

Project Structure

.vibedeck/                    # In your project
├── manifest.json             # Project manifest
├── INSTRUCTIONS.md           # AI instructions
├── finance/                  # Finance app
│   ├── vibe.json             # App config
│   ├── ui/                   # UI files
│   └── data/                 # JSON data
├── assistant/                # Notes & Todos
└── calendar/                 # Events

Built-in Apps

Finance

Track income, expenses, and savings goals.

MCP Tools:

• finance_add_transaction - Add income/expense
• finance_get_balance - Get balance by period
• finance_set_goal - Create savings goal

Assistant

Notes, todos, and personal goals hub.

MCP Tools:

• assistant_add_todo - Create task
• assistant_add_note - Create note (markdown)
• assistant_update_todo_status - Update task status

Calendar

Event management and scheduling.

MCP Tools:

• calendar_add_event - Create event
• calendar_get_events - Get events by date range
• calendar_get_today - Get today's events

MCP Server Setup

For use with Claude Desktop or other MCP clients:

1. Build the MCP server:

cd mcp-server
npm install
npm run build

2. Add to your MCP config (~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "vibedeck": {
      "command": "node",
      "args": ["/path/to/vibedeck/mcp-server/dist/index.js"],
      "env": {
        "VIBEDECK_APPS_PATH": "/path/to/your/project/.vibedeck"
      }
    }
  }
}

Architecture

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   VS Code UI    │────▶│  JSON Data Files │◀────│   MCP Server    │
│   (WebView)     │     │   (.vibedeck/)   │     │  (AI Tools)     │
└─────────────────┘     └──────────────────┘     └─────────────────┘
        │                       ▲                        │
        │                       │                        │
        ▼                       │                        ▼
   User clicks           FileWatcher              AI Assistant
   buttons              detects changes          uses MCP tools

Data Flow:

1. User asks AI to add a transaction
2. AI calls finance_add_transaction MCP tool
3. Tool writes to .vibedeck/data/finance/transactions.json
4. FileWatcher detects change
5. UI automatically refreshes

Documentation

• Standard Specification - vibe.json format
• Architecture - Technical details
• Create Your Own App - Build custom apps

Development

# Extension
cd extension
npm run watch        # Watch mode
npm run compile      # Build
npm run package      # Create .vsix

# MCP Server
cd mcp-server
npm run dev          # Watch mode
npm run build        # Build

Philosophy

VibeDeck follows three principles:

1. Files You Own: No cloud, no servers. Your data lives in your project as simple JSON files you can read, edit, and version control.

2. AI-Native: Built for AI assistants from the ground up. Every app exposes MCP tools that AI can use naturally.

3. Hackable: Vanilla HTML/CSS/JS apps. No build tools required. Modify the source, extend functionality, create your own apps.

License

MIT