VibecodeCLI - AI-Powered Coding Assistant

VibecodeCLI is an intelligent command-line tool that transforms how developers interact with their codebase. Using advanced AI models, it understands natural language requests and executes code changes, creates files, runs commands, and provides intelligent assistance - all through simple conversation.

Installation

npm install -g vibecodecli

Quick Start

# Start vibecode in your project directory
vibecodecli

# Or specify a custom API endpoint
VIBECODECLI_API_URL=https://your-api.com vibecodecli

Features

• 🤖 Natural Language Interface - Just describe what you want in plain English
• ✨ Auto-Execute Actions - AI automatically creates, edits files and runs commands with your approval
• 🔍 Context-Aware Search - RAG-powered semantic search finds relevant code instantly
• 🛠️ Multi-File Operations - Handle complex changes across multiple files effortlessly
• 🧠 Advanced AI Models - Powered by state-of-the-art language models optimized for code
• 🐛 Intelligent Debugging - Get help understanding and fixing errors with full context
• 🔄 Smart Refactoring - Improve code quality while maintaining functionality
• 📊 Project Understanding - AI comprehends your entire codebase structure
• 💾 Conversation Memory - Resume previous sessions and maintain context
• 🔒 Local-First Security - Your code never leaves your machine
• 🔄 Auto-Updates - Automatically stays up-to-date with the latest improvements

Usage

After installation, simply run vibecodecli in your project directory:

cd your-project
vibecodecli

Example Commands

Once in the Vibecode interface, you can ask:

Code Creation:

• "Create a new REST API endpoint for user profiles"
• "Write a React component for a todo list"
• "Generate unit tests for the auth module"

Code Understanding:

• "Explain how the authentication system works"
• "Show me all API endpoints in this project"
• "Find all database queries related to users"

Debugging & Fixes:

• "Fix the TypeError in auth.js line 45"
• "Why is this function returning undefined?"
• "Debug the login flow and fix any issues"

Refactoring:

• "Refactor this callback code to use async/await"
• "Extract this logic into a reusable function"
• "Optimize this database query for better performance"

Direct Commands:

• "create utils/helpers.js" - Quick file creation
• "edit src/index.js" - Direct file editing

Authentication

On first run, you'll be prompted to authenticate. You can:

• Login with existing account
• Create a new account
• Use device code authentication

How It Works

1. Analyze - Vibecode analyzes your project structure and code context
2. Understand - AI comprehends your natural language request
3. Plan - Generates appropriate actions (file edits, creation, commands)
4. Confirm - Shows you what it will do and asks for approval
5. Execute - Performs the approved actions on your codebase

Configuration

Environment Variables

• VIBECODECLI_API_URL - Custom API endpoint (default: https://api.datamolecule.ai/vibecodecli)
• VIBECODECLI_NO_TELEMETRY - Disable anonymous usage statistics

Config File

Vibecode stores configuration in ~/.vibecode/config.json:

{
  "apiUrl": "https://api.datamolecule.ai/vibecodecli",
  "theme": "auto",
  "editor": "default",
  "telemetry": true,
  "autoUpdate": true,
  "confirmActions": true
}

Auto-Updates

VibecodeCLI automatically checks for updates and installs them in the background. To disable:

vibecodecli config set autoUpdate false

Privacy & Security

• Local Code Analysis - Your code is analyzed locally and never stored on our servers
• Minimal Data Transfer - Only relevant code snippets are sent as context
• Secure Authentication - Token storage using system keychain (macOS/Windows) or encrypted file
• HTTPS Only - All API communications are encrypted
• No Training on Your Code - Your code is never used to train AI models
• Action Confirmation - All file changes require your explicit approval

Requirements

• Node.js 16.0.0 or higher
• Git (for repository analysis)
• Internet connection for AI features
• 100MB free disk space for local cache

Troubleshooting

Common Issues

"Authentication failed"

• Check your internet connection
• Try logging in again with vibecodecli --login

"Cannot find project root"

• Make sure you're in a directory with a git repository or package.json
• Use vibecodecli --project /path/to/project to specify the project path

"Actions not executing"

• Ensure you're approving actions when prompted
• Check file permissions in your project directory
• Run with --verbose to see detailed action logs

"API request failed"

• Check if the API service is accessible
• Verify your authentication token is valid

Debug Mode

Run with debug logging:

DEBUG=vibecodecli* vibecodecli

Advanced Usage

Command Flags

vibecodecli --help              # Show help
vibecodecli --version           # Show version
vibecodecli --login             # Re-authenticate
vibecodecli --logout            # Clear authentication
vibecodecli --project /path     # Specify project directory
vibecodecli --no-confirm        # Skip action confirmations (use with caution)
vibecodecli --verbose           # Show detailed logs

Integration with IDEs

VibecodeCLI can be integrated with your favorite editor:

• VS Code: Use the integrated terminal
• IntelliJ: Configure as external tool
• Vim/Neovim: Use :terminal or async job

Support

• Issues: https://datamolecule.ai

License

MIT License - see LICENSE file for details

Contributing

Built with ❤️ by developers, for developers

VibecodeCLI - Where natural language meets code execution