🎤 Voice Command CLI

Powerful voice-controlled command line interface with 100+ commands, AI-powered natural language processing, and beautiful terminal UI

Transform your terminal experience with voice commands! Execute Git operations, manage files, run Docker containers, and more - all with natural language voice input.

✨ Features

• 🎙️ Voice Recognition - Speak naturally to control your terminal
• 🤖 AI-Powered - Cerebras AI understands commands even when not exact
• 🎨 Beautiful UI - Stunning terminal interface with colors and animations
• 📦 100+ Commands - Comprehensive coverage across multiple categories
• 🔄 Smart Fallback - Two-tier recognition system with AI assistance
• 🌐 Cross-Platform - Works on Windows with Python support

🚀 Quick Start

Prerequisites

• Node.js 16 or higher
• Python 3.7+ with pip
• Microphone for voice input

Installation

npm install -g voice-command-cli

Python Dependencies

The CLI will attempt to auto-install these, but you can install manually:

pip install SpeechRecognition pyaudio

Setup

1. Create a .env file in your project directory or set environment variable:

CEREBRAS_API_KEY=your_api_key_here

Get your free API key at Cerebras Cloud

2. Run the CLI:

voice-cli

Or if installed locally:

npm start

🎯 Usage

Once started, simply speak your commands clearly into your microphone. The CLI supports natural language variations.

Example Commands

File Operations:

• "list files"
• "create folder my-project"
• "delete file test.txt"
• "go back" (navigate to parent directory)

Git Commands:

• "git status"
• "git add all"
• "git commit fix bug"
• "git push"

Node/NPM:

• "npm install"
• "npm run dev"
• "install package express"

Docker:

• "docker ps"
• "docker build my-app"
• "docker compose up"

Python:

• "run python app.py"
• "pip install requests"
• "create virtual environment"

System:

• "ip address"
• "check disk space"
• "list processes"

AI Fallback

If a command isn't recognized on the first try, speak it again. The second time, the AI will interpret your intent and suggest the appropriate command.

📚 Command Categories

• 📁 File Operations (16 commands)
• 🔀 Git Commands (14 commands)
• 📦 Node/NPM (14 commands)
• 🐍 Python (12 commands)
• ⚛️ React/Vite/Next (3 commands)
• 📱 Flutter (7 commands)
• 💻 C/C++ (5 commands)
• ☕ Java (5 commands)
• 🐳 Docker (11 commands)
• ⚙️ System Commands (11 commands)
• ✏️ Editor Commands (3 commands)
• 🌐 Networking (3 commands)
• 🔧 Miscellaneous (6 commands)

Say "help" while running to see all available commands.

🛠️ Configuration

Environment Variables

• CEREBRAS_API_KEY - Required for AI fallback feature

Custom Commands

Edit commands.json to add your own commands. Structure:

{
  "patterns": ["trigger phrase 1", "trigger phrase 2"],
  "command": "shell command to execute",
  "description": "What this command does",
  "needsParam": false
}

For commands with parameters:

{
  "patterns": ["git commit"],
  "command": "git commit -m \"{message}\"",
  "description": "Commit changes",
  "needsParam": true,
  "paramName": "message"
}

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.