VibeDeck - VS Code Extension
LLM-first personal app platform - files-based, AI-native productivity apps
⚠️ Status: Beta
This extension is in active development. Core features work, but you may encounter bugs or breaking changes between versions.
What works:
- VS Code sidebar with app UI
- Built-in apps (Finance, Goals, Calendar, etc.)
- MCP integration with Claude and Copilot
- JSON file-based data storage
Known limitations:
- Some edge cases in data sync
- UI polish in progress
Found a bug? Please report it on GitHub - your feedback helps!
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 assistant
- VS Code Native: Runs as a VS Code extension with sidebar UI
- Built-in Apps: Finance tracker, Goals, Calendar, and more
- Zero Setup: Initialize in any project with one click
- Language Model Tools: Native VS Code LM API integration for Copilot
Installation
- Install from VS Code Marketplace (search for "VibeDeck")
- Or install from VSIX file
Quick Start
- Open any folder in VS Code
- VibeDeck will prompt you to initialize
- Click "Initialize VibeDeck" and select apps to install
- Your
.vibedeck/ folder is ready!
Or run command: VibeDeck: Initialize in Workspace
Usage with AI
VibeDeck provides MCP tools that AI assistants can use:
You: "Add $50 expense for groceries"
AI: [uses finance tools]
UI: Automatically updates!
VS Code Copilot Integration
VibeDeck exposes Language Model Tools for Copilot:
vibedeck_list_apps - List all installed apps
vibedeck_read_data - Read app data
vibedeck_write_data - Write app data
vibedeck_append_list - Add items to lists
- And more...
Claude Desktop / MCP Integration
Connect VibeDeck to Claude Desktop or any MCP-compatible client:
- Run command:
VibeDeck: Connect to Claude Code (MCP)
- Follow the setup instructions
Data 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
├── goals/ # Goals tracker
└── calendar/ # Events
Commands
| Command |
Description |
VibeDeck: Initialize in Workspace |
Set up VibeDeck in current folder |
VibeDeck: Open App |
Open a specific app |
VibeDeck: Refresh Current App |
Reload current app |
VibeDeck: Connect to Claude Code (MCP) |
Configure MCP server |
VibeDeck: Copy App Creation Prompt |
Generate new app with AI |
VibeDeck: Install from Git |
Install app from Git repository |
Configuration
| Setting |
Description |
Default |
vibedeck.appsPath |
Path to apps directory |
./.vibedeck |
vibedeck.devMode |
Enable dev watch mode |
true |
vibedeck.ai.provider |
AI provider (anthropic/openai) |
null |
vibedeck.telemetry.enabled |
Enable anonymous telemetry |
true |
Philosophy
- Files You Own: No cloud, no servers. Your data lives in your project as simple JSON files.
- AI-Native: Built for AI assistants. Every app exposes tools that AI can use naturally.
- Hackable: Vanilla HTML/CSS/JS apps. No build tools required.
Links
License
MIT - see LICENSE for details.