claude-dev-cli 0.13.0__tar.gz → 0.16.0__tar.gz

{claude_dev_cli-0.13.0/src/claude_dev_cli.egg-info → claude_dev_cli-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-dev-cli
-Version: 0.13.0
+Version: 0.16.0
 Summary: A powerful CLI tool for developers using Claude AI with multi-API routing, test generation, code review, and usage tracking
 Author-email: Julio <thinmanj@users.noreply.github.com>
 License: MIT
@@ -29,6 +29,7 @@ Requires-Dist: pydantic>=2.0.0
 Requires-Dist: keyring>=24.0.0
 Requires-Dist: cryptography>=41.0.0
 Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: unidiff>=0.7.0
 Provides-Extra: toon
 Requires-Dist: toon-format>=0.1.0; extra == "toon"
 Provides-Extra: plugins
@@ -37,6 +38,15 @@ Provides-Extra: generation
 Requires-Dist: pypdf>=3.0.0; extra == "generation"
 Requires-Dist: requests>=2.28.0; extra == "generation"
 Requires-Dist: beautifulsoup4>=4.0.0; extra == "generation"
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: ollama
+Requires-Dist: requests>=2.28.0; extra == "ollama"
+Provides-Extra: local
+Requires-Dist: requests>=2.28.0; extra == "local"
+Provides-Extra: all-providers
+Requires-Dist: openai>=1.0.0; extra == "all-providers"
+Requires-Dist: requests>=2.28.0; extra == "all-providers"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
@@ -62,9 +72,25 @@ A powerful command-line tool for developers using Claude AI with multi-API routi
 
 ## Features
 
+### 🌐 Multi-Provider AI Support (v0.14.0+)
+- **Anthropic (Claude)**: GPT-4 class models with 200k context
+  - Haiku, Sonnet, Opus - full model family
+  - Industry-leading context window
+- **OpenAI (GPT)**: ChatGPT and GPT-4 models (v0.15.0+)
+  - GPT-3.5 Turbo, GPT-4, GPT-4 Turbo
+  - Azure OpenAI support
+  - Install: `pip install 'claude-dev-cli[openai]'`
+- **Ollama (Local)**: Zero-cost local inference (v0.16.0+)
+  - Mistral, Mixtral, Code Llama, DeepSeek Coder
+  - 100% free, private, offline
+  - Install: `pip install 'claude-dev-cli[ollama]'`
+- **Provider Abstraction**: Unified interface across all providers
+- **Cost Tracking**: Per-provider usage and cost monitoring
+- **Graceful Fallback**: Works with any combination of providers
+
 ### 🔑 Multi-API Key Management
 - **Secure Storage**: API keys stored in system keyring (macOS Keychain, Linux Secret Service, Windows Credential Locker)
-- Route tasks to different Claude API keys (personal, client, enterprise)
+- Route tasks to different API keys/providers (personal, client, enterprise, local)
 - Automatic API selection based on project configuration
 - Automatic migration from plaintext to secure storage
 
@@ -172,34 +198,118 @@ brew install thinmanj/tap/claude-dev-cli
 
 ### Via pip
 
+#### Basic Installation
+
+Core dependencies only (includes unidiff for diff parsing):
+
 ```bash
-# Basic installation
 pip install claude-dev-cli
+```
 
-# With code generation support (PDF & URL input)
-pip install claude-dev-cli[generation]
+Core dependencies:
+- `anthropic>=0.18.0` - Claude API client
+- `click>=8.1.0` - CLI framework
+- `rich>=13.0.0` - Terminal formatting
+- `pydantic>=2.0.0` - Data validation
+- `keyring>=24.0.0` - Secure credential storage
+- `cryptography>=41.0.0` - Encryption for secure storage
+- `pyyaml>=6.0.0` - YAML configuration support
+- `unidiff>=0.7.0` - Production-grade diff parsing
 
-# With TOON support (30-60% token reduction)
-pip install claude-dev-cli[toon]
+#### With Optional Features
 
-# With all optional features
-pip install claude-dev-cli[generation,toon]
+**Multi-Provider Support**:
+
+```bash
+# OpenAI (GPT) support
+pip install 'claude-dev-cli[openai]'
+
+# Ollama (local/free) support
+pip install 'claude-dev-cli[ollama]'
+
+# All providers
+pip install 'claude-dev-cli[all-providers]'
+```
+
+**Code Generation Support** (PDF & URL input):
+
+```bash
+pip install 'claude-dev-cli[generation]'
+```
+
+Adds:
+- `pypdf>=3.0.0` - PDF text extraction
+- `requests>=2.28.0` - HTTP client for URL fetching
+- `beautifulsoup4>=4.0.0` - HTML parsing
+
+**TOON Format Support** (30-60% token reduction):
+
+```bash
+pip install 'claude-dev-cli[toon]'
+```
+
+Adds:
+- `toon-format>=0.1.0` - TOON encoding/decoding
+
+**Syntax Highlighting** (enhanced diff display):
+
+```bash
+pip install 'claude-dev-cli[plugins]'
 ```
 
+Adds:
+- `pygments>=2.0.0` - Syntax highlighting for diffs
+
+**All Optional Features**:
+
+```bash
+pip install 'claude-dev-cli[generation,toon,plugins]'
+```
+
+**Development Installation** (for contributors):
+
+```bash
+pip install 'claude-dev-cli[dev]'
+```
+
+Includes all optional features plus:
+- `pytest>=7.0.0` - Testing framework
+- `black>=23.0.0` - Code formatting
+- `ruff>=0.1.0` - Linting
+- `mypy>=1.0.0` - Type checking
+
 ### Via pipx (Recommended for CLI tools)
 
+pipx provides isolated installations without affecting your system Python:
+
 ```bash
-# Isolated installation
+# Basic installation
 pipx install claude-dev-cli
 
-# With code generation support
-pipx install claude-dev-cli[generation]
+# With code generation support (PDF & URL)
+pipx install 'claude-dev-cli[generation]'
+
+# With TOON support (token reduction)
+pipx install 'claude-dev-cli[toon]'
 
-# With TOON support
-pipx install claude-dev-cli[toon]
+# With syntax highlighting
+pipx install 'claude-dev-cli[plugins]'
 
 # With all optional features
-pipx install claude-dev-cli[generation,toon]
+pipx install 'claude-dev-cli[generation,toon,plugins]'
+```
+
+### Upgrade Existing Installation
+
+```bash
+# Upgrade via pip
+pip install --upgrade claude-dev-cli
+
+# Upgrade via pipx
+pipx upgrade claude-dev-cli
+
+# Upgrade via Homebrew
+brew upgrade claude-dev-cli
 ```
 
 ## Quick Start
@@ -223,6 +333,78 @@ cdc config list
 cdc config migrate-keys
 ```
 
+### 1.1 Setup Ollama (Local/Free Alternative) - v0.16.0+
+
+Run AI models locally with **zero cost** and full privacy using Ollama:
+
+```bash
+# Install Ollama (one-time setup)
+# macOS/Linux: Download from https://ollama.ai
+# Or via Homebrew: brew install ollama
+
+# Start Ollama server
+ollama serve  # Run in background or separate terminal
+
+# Install Ollama support
+pip install 'claude-dev-cli[ollama]'
+
+# Configure local provider (no API key needed!)
+cdc config add ollama local --default
+# ℹ️  No API key needed for local provider
+
+# Pull models (one-time per model)
+cdc ollama pull mistral      # Fast, general-purpose (7B)
+cdc ollama pull codellama    # Code-specialized (7B-34B)
+cdc ollama pull mixtral      # Powerful reasoning (8x7B)
+
+# List available models
+cdc ollama list
+# ┌──────────────┬─────────────────┬─────────┬──────────┬─────────────────┐
+# │ Model        │ Display Name    │ Context │ Cost     │ Capabilities    │
+# │ mistral      │ Mistral 7B      │ 8,192   │ FREE     │ chat, code      │
+# │ codellama    │ Code Llama      │ 16,384  │ FREE     │ code, chat      │
+# │ mixtral      │ Mixtral 8x7B    │ 32,768  │ FREE     │ chat, analysis  │
+# └──────────────┴─────────────────┴─────────┴──────────┴─────────────────┘
+
+# Show model details
+cdc ollama show mistral
+```
+
+**Benefits of Local Models:**
+- ✅ **Zero Cost**: No API fees, unlimited usage
+- ✅ **Privacy**: Data never leaves your machine
+- ✅ **Offline**: Works without internet connection
+- ✅ **Fast**: No API latency (after model loads)
+- ✅ **Control**: Full control over models and data
+
+**Considerations:**
+- ⚠️ Requires decent hardware (8GB+ RAM, GPU recommended)
+- ⚠️ Models need disk space (4-40GB per model)
+- ⚠️ Quality may be lower than GPT-4/Claude Opus
+- ⚠️ Initial model download can take time
+
+**Use Local Models:**
+```bash
+# Use with any command - completely FREE!
+cdc ask "explain async/await"
+cdc ask -m fast-local "quick question"
+cdc generate tests -m code-local mymodule.py
+cdc review -m smart-local src/
+
+# Use specific model directly
+cdc ask -m mistral "your question"
+cdc ask -m codellama "write a function to parse JSON"
+
+# Remote Ollama server
+cdc config add ollama remote --base-url http://server:11434
+cdc ask -a remote "question"
+```
+
+**Available Model Profiles:**
+- `fast-local`: mistral (8k context, fast inference)
+- `smart-local`: mixtral (32k context, powerful)
+- `code-local`: codellama (16k context, code-focused)
+
 ### 2. Basic Usage
 
 ```bash
@@ -315,8 +497,108 @@ cdc generate feature --file spec.md --yes  # Apply without confirmation
 
 # Interactive feature implementation
 cdc generate feature --description "Add logging" src/ --interactive
+
+# Hunk-by-hunk approval (like git add -p) - NEW in v0.13.1
+cdc generate feature -f spec.md
+# At confirmation prompt, type 'patch' to review changes hunk-by-hunk
+# Options: y (yes), n (no), s (skip file), q (quit), help
+```
+
+### 3.1 Interactive Diff Approval (v0.13.1+)
+
+When applying file modifications, you can review and approve changes hunk-by-hunk, similar to `git add -p`:
+
+```bash
+# After generating feature/refactor changes:
+cdc generate feature -f spec.md
+
+# At the confirmation prompt:
+Continue? (Y/n/preview/patch/help) patch
+
+# For each file:
+File: src/main.py
+Modify file (3 hunk(s))
+
+Hunk 1/3:
+[Shows diff with syntax highlighting]
+@@ -10,3 +10,5 @@
+ def main():
+-    print("old")
++    print("new")
++    logging.info("Started")
+
+Apply this hunk? (y/n/s=skip file/q=quit/help) y  # Approve this hunk
+
+Hunk 2/3:
+[Shows next diff]
+Apply this hunk? (y/n/s=skip file/q=quit/help) n  # Skip this hunk
+
+Hunk 3/3:
+[Shows final diff]
+Apply this hunk? (y/n/s=skip file/q=quit/help) s  # Skip remaining in file
+
+# File operations options:
+Create this file? (y/n/s=skip/q=quit) y  # For new files
+Delete this file? (y/n/s=skip/q=quit) n  # For file deletions
 ```
 
+**Options:**
+- `y, yes` - Apply this hunk/file
+- `n, no` - Skip this hunk (keeps original)
+- `s, skip` - Skip remaining hunks in current file
+- `q, quit` - Stop reviewing and apply approved changes so far
+- `edit` - Open files in $EDITOR before applying
+- `save` - Save to custom location
+- `help` - Show help message
+
+**Benefits:**
+- Fine-grained control over changes
+- Keep original code for some hunks while applying others
+- Syntax-highlighted diffs for easy review
+- Edit files before applying for manual tweaks
+- Save to custom location without -o flag
+- Safe: only approved hunks are written
+
+### 3.2 Edit and Save Options (v0.13.2+)
+
+Before applying changes, you can edit files or save to custom locations:
+
+#### Edit in $EDITOR
+```bash
+cdc generate feature -f spec.md
+
+# At confirmation:
+Continue? (Y/n/preview/patch/edit/save/help) edit
+
+# Opens each file in your $EDITOR (vi, nano, code, etc.)
+# Make manual adjustments, save and close
+# Changes are applied after editing
+```
+
+#### Save to Custom Location
+```bash
+cdc generate code -d "REST API" -o /tmp/output
+
+# At confirmation:
+Continue? (Y/n/preview/patch/edit/save/help) save
+
+# Single file:
+Filename: my-custom-name.py  # Save to custom filename
+
+# Multiple files:
+Directory: /path/to/output/  # Save entire project elsewhere
+```
+
+**Use Cases:**
+- **Edit**: Make manual tweaks before applying (fix formatting, adjust logic)
+- **Save**: Try changes elsewhere before applying to project
+- **Edit + Preview**: Review, edit, then apply with confidence
+- **Save for later**: Generate code, save it, review offline, apply manually
+
+**Environment Variables:**
+- `$EDITOR`: Your preferred editor (e.g., `export EDITOR=nano`)
+- Defaults to `vi` if `$EDITOR` not set
+
 ### 4. Developer Commands
 
 ```bash