voxcmd 1.2.0

A powerful AI assistant and file manager for your terminal

VoxCmd

A powerful AI assistant and file manager for your terminal, powered by Google Gemini 1.5 Flash.

Features

• 🤖 AI-Powered Assistant: Chat with AI or get command suggestions
• 📁 File Management: Create, view, delete, and find files easily
• 🚀 Natural Language Commands: Describe what you want, get the right command
• 🎨 Rich Terminal Output: Beautiful formatting with Rich library
• ⚡ Fast and Lightweight: Built with Typer for optimal performance

Installation

pip install voxcmd

Quick Start

1. Set your Gemini API key:

   voxcmd set-api-key YOUR_GEMINI_API_KEY
   

2. Start using VoxCmd:

   # Ask the AI anything
   voxcmd ask "create a python file that prints hello world"
   
   # View files
   voxcmd view myfile.txt
   
   # Create files directly
   voxcmd create-file app.py --content "print('Hello World!')"
   

Available Commands

• voxcmd ask "your question" - Ask the AI assistant anything
• voxcmd set-api-key <key> - Configure your Gemini API key
• voxcmd create-file <path> --content "..." - Create files with content
• voxcmd view <filepath> - Display file contents
• voxcmd delete <path> - Delete files or directories
• voxcmd find <name> - Find files by name
• voxcmd open-path <path> - Open files/directories in default application
• voxcmd hello <name> - Say hello (example command)
• voxcmd goodbye - Say goodbye

Getting a Gemini API Key

1. Go to Google AI Studio
2. Create a new API key
3. Use it with voxcmd set-api-key YOUR_KEY

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.