What is Vibes

Vibes is an interactive learning platform that allows users to learn anything through conversation with Claude Desktop, a virtual assistant that can execute commands, analyze code, and maintain persistent memory.

Use cases

Use cases for Vibes include learning programming languages by building games, creating websites, and understanding complex concepts through guided conversations with Claude.

How to use

To use Vibes, simply set it up on your preferred platform (Mac, Windows, or Linux) following the provided guides. Once set up, you can engage in conversations with Claude to learn by asking questions and building projects together.

Key features

Key features of Vibes include shell access, persistent memory, code analysis capabilities, and a user-friendly interface designed for individuals without a technical background.

Where to use

Vibes can be used in educational settings, personal learning, software development, and any scenario where interactive learning and project building are beneficial.

Vibes - Conversational Development Environment

Vibes transforms Claude Desktop into a conversational development environment through distributed MCP servers. Instead of learning command-line tools, you describe what you want to build and Claude implements it while teaching you.

Current State

Core Philosophy: Ask → Build → Understand → Improve → Create

Working Components:

• Shell access and code execution in isolated containers
• Persistent memory across conversations via vector database
• Repository analysis and code understanding
• INMPARA knowledge management system
• Azure, Terraform, and GitHub integrations

Architecture: Claude Desktop + MCP servers + Docker containers + Vector DB

MCP Server Ecosystem

Future Vision

Expanding toward observable AI execution and team collaboration:

Phase 1: Observable Agent Execution

• Real-time screen sharing of AI work (terminal, browser, Neovim)
• Agent-specific environments with persistent state
• Pause/resume execution controls

Phase 2: Team Collaboration

• Discord-like interface for human-AI teams
• Multi-user knowledge spaces
• Agent coordination visualization

Phase 3: Advanced Intelligence

• Cross-session agent learning and skill accumulation
• Intelligent task routing between specialized agents
• Predictive workflow assistance

Quick Start

git clone https://github.com/jonhill90/vibes.git
cd mcp/mcp-vibes-server
docker network create vibes-network
docker-compose up -d

Configure Claude Desktop MCP settings

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "vibes": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "mcp-vibes-server",
        "python3",
        "/workspace/server.py"
      ]
    }
  }
}

Current Capabilities

• Execute code in safe, isolated environments
• Remember conversations and build knowledge over time
• Analyze any GitHub repository
• Build real projects with infrastructure automation
• Learn through hands-on conversation rather than documentation

Conversational development environment in production. Observable AI execution in development.