Metadata-Version: 2.4
Name: voxcmd
Version: 1.2.0
Summary: A powerful AI assistant and file manager for your terminal
Author-email: Santhosh Sharuk <santhoshsharuk16@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/santhoshsharuk/voc-cmd
Project-URL: Repository, https://github.com/santhoshsharuk/voc-cmd
Project-URL: Issues, https://github.com/santhoshsharuk/voc-cmd/issues
Project-URL: Documentation, https://github.com/santhoshsharuk/voc-cmd#readme
Keywords: ai,assistant,cli,gemini,file-manager,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer[all]>=0.9.0
Requires-Dist: google-generativeai>=0.3.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: flake8>=5.0.0; extra == "dev"
Dynamic: license-file

# 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

```bash
pip install voxcmd
```

## Quick Start

1. **Set your Gemini API key**:
   ```bash
   voxcmd set-api-key YOUR_GEMINI_API_KEY
   ```

2. **Start using VoxCmd**:
   ```bash
   # 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](https://makersuite.google.com/app/apikey)
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.
