vmcode-cli 1.0.0

package/config.yaml.example

@@ -0,0 +1,159 @@
+# =============================================================================
+# vmCode Configuration Example
+# =============================================================================
+#
+# Copy this file to config.yaml and add your API keys
+#
+# API keys can also be set via environment variables (they take precedence):
+#   export OPENAI_API_KEY="sk-your-key-here"
+#   export ANTHROPIC_API_KEY="sk-ant-your-key-here"
+#   export GLM_API_KEY="your-glm-key-here"
+#   export GEMINI_API_KEY="your-gemini-key-here"
+#   export OPENROUTER_API_KEY="sk-or-your-key-here"
+#   export KIMI_API_KEY="your-kimi-key-here"
+#   export MINIMAX_API_KEY="your-minimax-key-here"
+#
+# Or set interactively in the app:
+#   /key sk-your-api-key-here
+#   /provider openai
+#
+# =============================================================================
+
+# Last selected provider (saved automatically)
+LAST_PROVIDER: vmcode_free
+
+# =============================================================================
+# API KEYS
+# =============================================================================
+
+# OpenAI (GPT models)
+OPENAI_API_KEY: "sk-your-openai-key-here"
+OPENAI_MODEL: gpt-4o-mini
+OPENAI_API_BASE: "https://api.openai.com/v1"
+
+# Anthropic (Claude models)
+ANTHROPIC_API_KEY: "sk-ant-your-anthropic-key-here"
+ANTHROPIC_MODEL: claude-3-5-sonnet-20241022
+ANTHROPIC_API_BASE: "https://api.anthropic.com/v1"
+
+# Google (Gemini models)
+GEMINI_API_KEY: "your-gemini-key-here"
+GEMINI_MODEL: gemini-1.5-flash
+GEMINI_API_BASE: "https://generativelanguage.googleapis.com/v1beta"
+
+# Zhipu AI (GLM models)
+GLM_API_KEY: "your-glm-key-here"
+GLM_MODEL: glm-4-flash
+GLM_API_BASE: "https://open.bigmodel.cn/api/paas/v4"
+
+# OpenRouter (multi-provider API)
+OPENROUTER_API_KEY: "sk-or-your-openrouter-key-here"
+OPENROUTER_MODEL: openai/gpt-4o-mini
+OPENROUTER_API_BASE: "https://openrouter.ai/api/v1"
+
+# Kimi (Moonshot AI)
+KIMI_API_KEY: "your-kimi-key-here"
+KIMI_MODEL: moonshot-v1-8k
+KIMI_API_BASE: "https://api.moonshot.cn/v1"
+
+# MiniMax
+MINIMAX_API_KEY: "your-minimax-key-here"
+MINIMAX_MODEL: "abab6.5s-chat"
+MINIMAX_API_BASE: "https://api.minimax.chat/v1"
+
+# vmCode Free Tier (no API key needed - managed by vmCode proxy)
+VMCODE_FREE_API_BASE: "https://vmcode-five.vercel.app"
+
+# =============================================================================
+# LOCAL MODEL SETTINGS (Optional)
+# =============================================================================
+# Uncomment to use local models via llama.cpp
+
+LOCAL_MODEL_PATH: "/path/to/your/model.gguf"
+LOCAL_SERVER_PATH: "/path/to/llama.cpp/build/bin/llama-server"
+
+# =============================================================================
+# SETTINGS
+# =============================================================================
+
+# =============================================================================
+# TOOL SETTINGS
+# =============================================================================
+
+# Tool execution limits and defaults
+TOOL_SETTINGS:
+  max_tool_calls: 100           # Maximum number of tool calls per interaction
+  command_timeout_sec: 30       # Timeout for shell commands in seconds
+  enable_parallel_execution: true  # Enable parallel tool execution
+  max_parallel_workers: 10      # Maximum number of parallel tool workers
+  max_command_output_lines: 100 # Maximum lines to show from command output
+  max_file_preview_lines: 200   # Maximum lines to show in file creation previews
+
+# =============================================================================
+# FILE SETTINGS
+# =============================================================================
+
+# File scanning and reading limits
+FILE_SETTINGS:
+  max_file_bytes: 200000        # Maximum bytes to read from a single file (~200KB)
+  max_total_bytes: 1500000     # Maximum total bytes across all file reads (~1.5MB)
+  exclude_dirs:                # Directories to exclude from file operations
+    - .git
+    - .venv
+    - __pycache__
+    - node_modules
+    - venv
+    - env
+
+# =============================================================================
+# SERVER SETTINGS (Optional)
+# =============================================================================
+# Local llama-server configuration (only used for local models)
+SERVER_SETTINGS:
+  ngl_layers: 30                  # Number of GPU layers for llama.cpp
+  ctx_size: 8192                  # Context size for local model
+  n_predict: 8192                 # Maximum tokens to predict
+  rope_scale: 1.0                 # RoPE scaling factor
+  health_check_timeout_sec: 120   # Timeout for server health check
+  health_check_interval_sec: 1.0  # Interval between health checks
+
+# =============================================================================
+# CONTEXT SETTINGS
+# =============================================================================
+# Context compaction thresholds and defaults
+CONTEXT_SETTINGS:
+  compact_trigger_tokens: 100000 # Tokens threshold for auto-compaction
+  log_conversations: false       # Whether to log conversations to disk
+  conversations_dir: conversations # Directory for conversation logs
+  tool_compaction:
+    enable_per_message_compaction: true  # Enable per-message tool result compaction
+    keep_recent_tool_blocks: 3            # Number of recent tool blocks to keep
+    compact_failed_tools: true            # Whether to compact failed tool results
+
+# =============================================================================
+# SUB AGENT SETTINGS
+# =============================================================================
+# Configuration for sub-agent token limits and behavior
+SUB_AGENT_SETTINGS:
+  soft_limit_tokens: 75000      # Budget shown to agent in prompt (advisory)
+  hard_limit_tokens: 300000     # Hard stop - fail fast when exceeded (mandatory)
+  enable_compaction: false      # Disable auto-compaction for sub-agent sessions
+
+# =============================================================================
+# MODEL PRICING (Optional)
+# =============================================================================
+# Override default pricing for specific models (cost per 1M tokens)
+# Format: MODEL_PRICES:
+#   model_name:
+#     cost_in: 0.50
+#     cost_out: 1.50
+
+MODEL_PRICES: {}
+
+# =============================================================================
+# NOTES
+# =============================================================================
+# - Keep this file private! Never commit it to version control
+# - Set file permissions: chmod 600 config.yaml
+# - Environment variables override values in this file
+# - Run 'vmcode /help' for command reference

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "vmcode-cli",
+  "version": "1.0.0",
+  "description": "A terminal-based AI coding assistant powered by OpenAI-style function calling",
+  "main": "src/ui/main.py",
+  "bin": {
+    "vmcode": "./bin/npm-wrapper.js"
+  },
+  "scripts": {
+    "install": "node scripts/install.js",
+    "postinstall": "echo 'vmcode installed! Run with: vmcode'",
+    "start": "node bin/npm-wrapper.js"
+  },
+  "keywords": [
+    "ai",
+    "coding-assistant",
+    "terminal",
+    "llm",
+    "function-calling",
+    "python",
+    "gpt",
+    "claude"
+  ],
+  "author": "Vincent Miranda <vincentmiranda65@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vincentm65/vmCode-CLI"
+  },
+  "bugs": {
+    "url": "https://github.com/vincentm65/vmCode-CLI/issues"
+  },
+  "homepage": "https://github.com/vincentm65/vmCode-CLI",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ]
+}

package/requirements.txt

@@ -0,0 +1,7 @@
+requests
+rich
+pathspec
+prompt-toolkit>=3.0.0
+ddgs
+pyyaml
+pygments

package/scripts/install.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+/**
+ * vmCode npm install script
+ * Handles Python dependency installation
+ */
+
+const { spawn, spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const packageDir = path.resolve(__dirname, '..');
+const requirementsFile = path.join(packageDir, 'requirements.txt');
+
+console.log('Installing vmCode...\n');
+
+function findPython() {
+  const possibleCommands = ['python3', 'python', 'python3.9', 'python3.10', 'python3.11', 'python3.12'];
+  
+  for (const cmd of possibleCommands) {
+    try {
+      const result = spawnSync(cmd, ['--version'], { stdio: 'pipe' });
+      if (result.status === 0) {
+        const version = result.stdout.toString() || result.stderr.toString();
+        console.log(`✓ Found ${cmd}: ${version.trim()}`);
+        return cmd;
+      }
+    } catch (e) {
+      // Continue to next command
+    }
+  }
+  
+  return null;
+}
+
+function installDependencies(pythonCmd) {
+  if (!fs.existsSync(requirementsFile)) {
+    console.log('⚠️  No requirements.txt found, skipping Python dependencies');
+    return Promise.resolve();
+  }
+  
+  console.log('\nInstalling Python dependencies...\n');
+  
+  return new Promise((resolve, reject) => {
+    const installProcess = spawn(pythonCmd, ['-m', 'pip', 'install', '-r', requirementsFile], {
+      stdio: 'inherit',
+      cwd: packageDir
+    });
+    
+    installProcess.on('close', (code) => {
+      if (code === 0) {
+        console.log('\n✓ Python dependencies installed successfully\n');
+        resolve();
+      } else {
+        reject(new Error(`pip install failed with exit code ${code}`));
+      }
+    });
+    
+    installProcess.on('error', (err) => {
+      reject(new Error(`Failed to run pip: ${err.message}`));
+    });
+  });
+}
+
+function setupConfig() {
+  const configFile = path.join(packageDir, 'config.yaml');
+  const configExample = path.join(packageDir, 'config.yaml.example');
+  
+  if (!fs.existsSync(configFile) && fs.existsSync(configExample)) {
+    console.log('Creating config.yaml from example...');
+    try {
+      fs.copyFileSync(configExample, configFile);
+      console.log('✓ config.yaml created');
+      console.log('\n⚠️  IMPORTANT: Edit config.yaml and add your API keys!');
+      console.log('   Or set them via environment variables:\n');
+      console.log('   export OPENAI_API_KEY="sk-your-key-here"\n');
+    } catch (e) {
+      console.log('⚠️  Failed to create config.yaml:', e.message);
+    }
+  }
+}
+
+async function main() {
+  try {
+    // Find Python
+    const pythonCmd = findPython();
+    
+    if (!pythonCmd) {
+      console.error('\n❌ Error: Python 3.9+ is not installed or not in PATH');
+      console.error('Please install Python from https://python.org');
+      console.error('\nAfter installing Python, run: npm install vmcode\n');
+      process.exit(1);
+    }
+    
+    // Check Python version
+    const versionResult = spawnSync(pythonCmd, ['-c', 'import sys; print(f"{sys.version_info.major}.{sys.version_info.minor}")'], {
+      stdio: 'pipe'
+    });
+    
+    if (versionResult.status === 0) {
+      const version = versionResult.stdout.toString().trim();
+      const [major, minor] = version.split('.').map(Number);
+      
+      if (major < 3 || (major === 3 && minor < 9)) {
+        console.error(`\n❌ Error: Python 3.9+ is required (found ${version})`);
+        console.error('Please install a newer version of Python from https://python.org\n');
+        process.exit(1);
+      }
+    }
+    
+    // Install dependencies
+    await installDependencies(pythonCmd);
+    
+    // Setup config
+    setupConfig();
+    
+    console.log('='.repeat(60));
+    console.log('vmCode installation complete!');
+    console.log('='.repeat(60));
+    console.log('\nRun vmcode with:');
+    console.log('  vmcode\n');
+    console.log('Or with npx:');
+    console.log('  npx vmcode\n');
+    
+  } catch (err) {
+    console.error('\n❌ Installation failed:', err.message);
+    console.error('\nTry installing dependencies manually:');
+    console.error('  python3 -m pip install -r requirements.txt\n');
+    process.exit(1);
+  }
+}
+
+main();

package/setup.bat

@@ -0,0 +1,114 @@
+@echo off
+REM vmCode setup script for Windows (git clone installation)
+REM This script sets up vmcode as a system command
+
+echo ==========================================
+echo   vmCode Setup
+echo ==========================================
+echo.
+
+REM Get script directory
+set "SCRIPT_DIR=%~dp0"
+set "PROJECT_ROOT=%SCRIPT_DIR%.."
+
+echo Project root: %PROJECT_ROOT%
+echo.
+
+REM Check Python
+echo Checking for Python 3.9+...
+python --version >nul 2>&1
+if errorlevel 1 (
+    echo Error: Python is not installed or not in PATH
+    echo Please install Python 3.9 or later from https://python.org
+    pause
+    exit /b 1
+)
+
+for /f "tokens=2" %%i in ('python --version 2^>^&1') do set PYTHON_VERSION=%%i
+echo Found Python %PYTHON_VERSION%
+
+REM Install Python dependencies
+echo.
+echo Installing Python dependencies...
+cd /d "%PROJECT_ROOT%"
+pip install -q -r requirements.txt
+
+if errorlevel 1 (
+    echo Failed to install Python dependencies
+    pause
+    exit /b 1
+)
+
+echo Python dependencies installed
+echo.
+
+REM Setup config
+if not exist "config.yaml" (
+    if exist "config.yaml.example" (
+        echo Creating config.yaml from example...
+        copy config.yaml.example config.yaml >nul
+        echo config.yaml created
+        echo.
+        echo IMPORTANT: Edit config.yaml and add your API keys!
+        echo    Or set them via environment variables:
+        echo    set OPENAI_API_KEY=sk-your-key-here
+        echo.
+    ) else (
+        echo Warning: config.yaml.example not found
+    )
+) else (
+    echo config.yaml already exists
+)
+
+REM Create vmcode command
+echo.
+echo Setting up vmcode command...
+
+REM Option 1: Create batch file in PATH
+set "USER_BIN=%USERPROFILE%\bin"
+if not exist "%USER_BIN%" mkdir "%USER_BIN%"
+
+REM Create vmcode.bat launcher
+(
+echo @echo off
+echo REM vmCode launcher
+echo cd /d "%PROJECT_ROOT%"
+echo python src/ui/main.py %%*
+) > "%USER_BIN%\vmcode.bat"
+
+echo Created command: %USER_BIN%\vmcode.bat
+
+REM Check if USER_BIN is in PATH
+echo %PATH% | find /i /c "%USER_BIN%" >nul
+if errorlevel 1 (
+    echo.
+    echo WARNING: %USER_BIN% is not in your PATH
+    echo.
+    echo To add to PATH ^(recommended^):
+    echo   1. Press Win key, search for "Environment Variables"
+    echo   2. Click "Edit the system environment variables"
+    echo   3. Click "Environment Variables..."
+    echo   4. Under "User variables", select "Path" and click "Edit"
+    echo   5. Click "New" and add: %%USERBIN%%
+    echo   6. Click OK on all dialogs
+    echo.
+    echo   Or run this command in PowerShell ^(temporary^):
+    echo   $env:Path += ";%%USERBIN%%"
+) else (
+    echo %USER_BIN% is already in PATH
+)
+
+echo.
+echo ==========================================
+echo   Setup Complete!
+echo ==========================================
+echo.
+echo Run vmcode:
+echo   vmcode
+echo.
+echo Or run directly:
+echo   cd %PROJECT_ROOT%
+echo   python src/ui/main.py
+echo.
+
+pause

package/setup.sh

@@ -0,0 +1,135 @@
+#!/bin/bash
+# vmCode setup script for git clone installation
+# This script sets up vmcode as a system command
+
+set -e
+
+echo "=========================================="
+echo "  vmCode Setup"
+echo "=========================================="
+echo ""
+
+# Get the directory where this script is located
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+echo "📁 Project root: $PROJECT_ROOT"
+echo ""
+
+# Check Python
+echo "🐍 Checking for Python 3.9+..."
+
+if ! command -v python3 &> /dev/null; then
+    echo "❌ Error: python3 is not installed"
+    echo "Please install Python 3.9 or later from https://python.org"
+    exit 1
+fi
+
+PYTHON_VERSION=$(python3 -c 'import sys; print(".".join(map(str, sys.version_info[:2])))')
+PYTHON_MAJOR=$(python3 -c 'import sys; print(sys.version_info.major)')
+PYTHON_MINOR=$(python3 -c 'import sys; print(sys.version_info.minor)')
+
+echo "✓ Found Python $PYTHON_VERSION"
+
+if [ "$PYTHON_MAJOR" -lt 3 ] || ([ "$PYTHON_MAJOR" -eq 3 ] && [ "$PYTHON_MINOR" -lt 9 ]); then
+    echo "❌ Error: Python 3.9+ is required (found $PYTHON_VERSION)"
+    exit 1
+fi
+
+echo ""
+
+# Install Python dependencies
+echo "📦 Installing Python dependencies..."
+cd "$PROJECT_ROOT"
+pip3 install -q -r requirements.txt
+
+if [ $? -eq 0 ]; then
+    echo "✓ Python dependencies installed"
+else
+    echo "❌ Failed to install Python dependencies"
+    exit 1
+fi
+
+echo ""
+
+# Setup config
+if [ ! -f "config.yaml" ]; then
+    if [ -f "config.yaml.example" ]; then
+        echo "⚙️  Creating config.yaml from example..."
+        cp config.yaml.example config.yaml
+        echo "✓ config.yaml created"
+        echo ""
+        echo "⚠️  IMPORTANT: Edit config.yaml and add your API keys!"
+        echo "   Or set them via environment variables:"
+        echo "   export OPENAI_API_KEY='sk-your-key-here'"
+        echo ""
+    else
+        echo "⚠️  Warning: config.yaml.example not found"
+    fi
+else
+    echo "✓ config.yaml already exists"
+fi
+
+# Create vmcode alias/command
+echo ""
+echo "🔗 Setting up vmcode command..."
+
+# Option 1: Create symlink to user's bin directory
+USER_BIN="$HOME/.local/bin"
+mkdir -p "$USER_BIN"
+
+if [ -w "$USER_BIN" ]; then
+    # Create a symlink to the main.py script
+    cat > "$USER_BIN/vmcode" << 'EOF'
+#!/bin/bash
+# vmCode launcher
+cd "$(dirname "$(readlink -f "$0")")/../.." || exit 1"
+python3 src/ui/main.py "$@"
+EOF
+    
+    chmod +x "$USER_BIN/vmcode"
+    echo "✓ Created command: $USER_BIN/vmcode"
+    
+    # Check if USER_BIN is in PATH
+    if [[ ":$PATH:" != *":$USER_BIN:"* ]]; then
+        echo ""
+        echo "⚠️  Add $USER_BIN to your PATH:"
+        echo ""
+        echo "   For bash (add to ~/.bashrc):"
+        echo "   export PATH=\"\$PATH:$USER_BIN\""
+        echo ""
+        echo "   For zsh (add to ~/.zshrc):"
+        echo "   export PATH=\"\$PATH:$USER_BIN\""
+        echo ""
+        echo "   Then reload your shell:"
+        echo "   source ~/.bashrc  # or source ~/.zshrc"
+        echo ""
+        echo "   Or just run:"
+        echo "   export PATH=\"\$PATH:$USER_BIN\""
+        echo ""
+    else
+        echo "✓ $USER_BIN is already in PATH"
+    fi
+else
+    # Option 2: Create alias in shell config
+    echo "⚠️  Cannot write to $USER_BIN"
+    echo ""
+    echo "Add this alias to your shell config (~/.bashrc or ~/.zshrc):"
+    echo ""
+    echo "   alias vmcode='cd $PROJECT_ROOT && python3 src/ui/main.py'"
+    echo ""
+    echo "Then reload your shell: source ~/.bashrc"
+fi
+
+echo ""
+echo "=========================================="
+echo "  Setup Complete!"
+echo "=========================================="
+echo ""
+echo "Run vmcode:"
+echo "  vmcode"
+echo ""
+echo "Or run directly:"
+echo "  cd $PROJECT_ROOT"
+echo "  python3 src/ui/main.py"
+echo ""

package/src/__init__.py

@@ -0,0 +1,4 @@
+"""vmCode - AI-powered coding assistant."""
+
+__version__ = "0.1.0"
+

package/src/core/__init__.py

@@ -0,0 +1 @@
+"""Core business logic for vmCode."""