Metadata-Version: 2.4
Name: cmdgen-ai-cli
Version: 0.1.0
Summary: AI-powered CLI tool to translate natural language into terminal commands
Requires-Python: >=3.9
Requires-Dist: google-genai>=0.1.0
Requires-Dist: prompt-toolkit>=3.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Provides-Extra: dev
Requires-Dist: black>=23.0; extra == 'dev'
Requires-Dist: flake8>=6.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Description-Content-Type: text/markdown

# cmdgen 🪄

An AI-powered CLI tool that translates your natural language into native terminal commands and lets you review them before execution. Powered by Google's Gemini API.

## Features

- **Natural Language to CLI:** Just type what you want to do.
- **Context-Aware:** Knows your OS (Windows/Linux/macOS), Shell, and Working Directory for perfect commands.
- **Interactive Execution:** Uses `prompt_toolkit` to let you tweak the AI's generated command before running it.
- **Safety First:** Warns you with bold yellow text if the command looks destructive (e.g., `rm`, `del`, `format`).
- **Auto-Updater:** Silently checks for updates so you're always running the best version.

## Installation

The recommended way to install Python CLI tools globally is using `pipx`:

```bash
pipx install cmdgen
```

*(Alternatively, you can `pip install cmdgen` in a virtual environment)*

## Quick Start

1. **Get an API Key:** Get a free Gemini API key from [Google AI Studio](https://aistudio.google.com/app/apikey).
2. **Configure your Key:**
   ```bash
   cmdgen config set --provider gemini --api-key "YOUR_API_KEY"
   ```
3. **Use the Tool:**
   ```bash
   cmdgen "find all python files larger than 10MB in the current directory"
   ```

You will see an explanation of the command, and an interactive prompt where you can edit it or just press `Enter` to run it!

## Configuration

View your current configuration (safely masked):
```bash
cmdgen config view
```

## Contributing
1. Clone the repository
2. Install dependencies: `pip install -e .[dev]`
3. Run tests: `pytest`

## License
MIT
