Metadata-Version: 2.4
Name: devtools-ai-cli
Version: 0.2.0
Summary: AI-powered CLI tools for developers
Author-email: Federico <fedejose@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/Eutectico/devtools-ai
Project-URL: Documentation, https://github.com/Eutectico/devtools-ai#readme
Project-URL: Repository, https://github.com/Eutectico/devtools-ai
Project-URL: Issues, https://github.com/Eutectico/devtools-ai/issues
Keywords: ai,cli,developer-tools,productivity
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer[all]>=0.9.0
Requires-Dist: rich>=13.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: mypy>=1.8.0; extra == "dev"
Requires-Dist: ruff>=0.3.0; extra == "dev"
Requires-Dist: black>=24.0.0; extra == "dev"
Dynamic: license-file

# DevTools-AI

AI-powered CLI tools for developers. Save hours on commits, code reviews, documentation, and debugging.

## Features

- **Commit Message Generator** - Semantic commits from your diffs
- **Code Reviewer** - Security, performance, and best practice checks (Pro)
- **Code Explainer** - Understand complex code instantly
- **Documentation Generator** - Auto-generate docstrings and docs
- **Bug Analyzer** - Root cause analysis from error logs (Pro)

## Installation

```bash
pip install devtools-ai
```

## Quick Start

### 1. Configure API Key

Edit `~/.devtools-ai/config.yaml` and add your OpenRouter API key:

```yaml
api_key: your-openrouter-api-key-here
```

Get a free API key at: https://openrouter.ai/

### 2. Generate Commit Messages

```bash
# Stage your changes
git add .

# Generate commit message
devtools-ai commit

# Auto-commit with generated message
devtools-ai commit -y
```

### 3. Explain Code

```bash
devtools-ai explain path/to/complex_file.py
```

### 4. Generate Documentation

```bash
devtools-ai doc path/to/file.py --doc-format google
```

### 5. Review Code (Pro)

```bash
# Review staged changes
devtools-ai review

# Review specific files
devtools-ai review src/app.py src/utils.py
```

### 6. Analyze Bugs (Pro)

```bash
devtools-ai bug error.log --context src/app.py
```

## Free vs Pro

| Feature | Free | Pro |
|---------|------|-----|
| Commit message generator | ✓ | ✓ |
| Code explainer | ✓ | ✓ |
| Documentation generator | ✓ | ✓ |
| Code reviewer | - | ✓ |
| Bug analyzer | - | ✓ |
| Price | $0 | $29 one-time |

Activate Pro license:
```bash
devtools-ai activate YOUR-LICENSE-KEY
```

## Configuration

Config file: `~/.devtools-ai/config.yaml`

```yaml
ai_provider: openrouter
api_key: your-key-here
default_model: openai/gpt-3.5-turbo
tier: free
auto_cache: true
cache_ttl_days: 30
```

## License

MIT - See LICENSE file for details.
