claude-dev-cli 0.13.3__tar.gz → 0.16.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of claude-dev-cli might be problematic. Click here for more details.

Files changed (55) hide show
  1. {claude_dev_cli-0.13.3/src/claude_dev_cli.egg-info → claude_dev_cli-0.16.1}/PKG-INFO +196 -15
  2. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/README.md +186 -14
  3. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/pyproject.toml +14 -1
  4. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/__init__.py +1 -1
  5. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/cli.py +231 -13
  6. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/config.py +95 -9
  7. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/core.py +48 -53
  8. claude_dev_cli-0.16.1/src/claude_dev_cli/providers/__init__.py +28 -0
  9. claude_dev_cli-0.16.1/src/claude_dev_cli/providers/anthropic.py +216 -0
  10. claude_dev_cli-0.16.1/src/claude_dev_cli/providers/base.py +168 -0
  11. claude_dev_cli-0.16.1/src/claude_dev_cli/providers/factory.py +114 -0
  12. claude_dev_cli-0.16.1/src/claude_dev_cli/providers/ollama.py +283 -0
  13. claude_dev_cli-0.16.1/src/claude_dev_cli/providers/openai.py +268 -0
  14. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/workflows.py +49 -1
  15. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1/src/claude_dev_cli.egg-info}/PKG-INFO +196 -15
  16. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli.egg-info/SOURCES.txt +6 -0
  17. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli.egg-info/requires.txt +13 -0
  18. claude_dev_cli-0.16.1/tests/test_core.py +188 -0
  19. claude_dev_cli-0.13.3/tests/test_core.py +0 -241
  20. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/LICENSE +0 -0
  21. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/MANIFEST.in +0 -0
  22. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/setup.cfg +0 -0
  23. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/commands.py +0 -0
  24. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/context.py +0 -0
  25. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/history.py +0 -0
  26. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/input_sources.py +0 -0
  27. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/multi_file_handler.py +0 -0
  28. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/path_utils.py +0 -0
  29. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/plugins/__init__.py +0 -0
  30. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/plugins/base.py +0 -0
  31. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/plugins/diff_editor/__init__.py +0 -0
  32. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/plugins/diff_editor/plugin.py +0 -0
  33. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/plugins/diff_editor/viewer.py +0 -0
  34. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/secure_storage.py +0 -0
  35. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/template_manager.py +0 -0
  36. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/templates.py +0 -0
  37. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/toon_utils.py +0 -0
  38. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/usage.py +0 -0
  39. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/warp_integration.py +0 -0
  40. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli.egg-info/dependency_links.txt +0 -0
  41. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli.egg-info/entry_points.txt +0 -0
  42. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli.egg-info/top_level.txt +0 -0
  43. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_cli.py +0 -0
  44. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_commands.py +0 -0
  45. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_config.py +0 -0
  46. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_context.py +0 -0
  47. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_diff_editor.py +0 -0
  48. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_history.py +0 -0
  49. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_input_sources.py +0 -0
  50. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_multi_file_handler.py +0 -0
  51. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_path_utils.py +0 -0
  52. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_secure_storage.py +0 -0
  53. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_template_manager.py +0 -0
  54. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_toon_utils.py +0 -0
  55. {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_usage.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: claude-dev-cli
3
- Version: 0.13.3
3
+ Version: 0.16.1
4
4
  Summary: A powerful CLI tool for developers using Claude AI with multi-API routing, test generation, code review, and usage tracking
5
5
  Author-email: Julio <thinmanj@users.noreply.github.com>
6
6
  License: MIT
@@ -38,6 +38,15 @@ Provides-Extra: generation
38
38
  Requires-Dist: pypdf>=3.0.0; extra == "generation"
39
39
  Requires-Dist: requests>=2.28.0; extra == "generation"
40
40
  Requires-Dist: beautifulsoup4>=4.0.0; extra == "generation"
41
+ Provides-Extra: openai
42
+ Requires-Dist: openai>=1.0.0; extra == "openai"
43
+ Provides-Extra: ollama
44
+ Requires-Dist: requests>=2.28.0; extra == "ollama"
45
+ Provides-Extra: local
46
+ Requires-Dist: requests>=2.28.0; extra == "local"
47
+ Provides-Extra: all-providers
48
+ Requires-Dist: openai>=1.0.0; extra == "all-providers"
49
+ Requires-Dist: requests>=2.28.0; extra == "all-providers"
41
50
  Provides-Extra: dev
42
51
  Requires-Dist: pytest>=7.0.0; extra == "dev"
43
52
  Requires-Dist: black>=23.0.0; extra == "dev"
@@ -63,9 +72,25 @@ A powerful command-line tool for developers using Claude AI with multi-API routi
63
72
 
64
73
  ## Features
65
74
 
75
+ ### 🌐 Multi-Provider AI Support (v0.14.0+)
76
+ - **Anthropic (Claude)**: GPT-4 class models with 200k context
77
+ - Haiku, Sonnet, Opus - full model family
78
+ - Industry-leading context window
79
+ - **OpenAI (GPT)**: ChatGPT and GPT-4 models (v0.15.0+)
80
+ - GPT-3.5 Turbo, GPT-4, GPT-4 Turbo
81
+ - Azure OpenAI support
82
+ - Install: `pip install 'claude-dev-cli[openai]'`
83
+ - **Ollama (Local)**: Zero-cost local inference (v0.16.0+)
84
+ - Mistral, Mixtral, Code Llama, DeepSeek Coder
85
+ - 100% free, private, offline
86
+ - Install: `pip install 'claude-dev-cli[ollama]'`
87
+ - **Provider Abstraction**: Unified interface across all providers
88
+ - **Cost Tracking**: Per-provider usage and cost monitoring
89
+ - **Graceful Fallback**: Works with any combination of providers
90
+
66
91
  ### 🔑 Multi-API Key Management
67
92
  - **Secure Storage**: API keys stored in system keyring (macOS Keychain, Linux Secret Service, Windows Credential Locker)
68
- - Route tasks to different Claude API keys (personal, client, enterprise)
93
+ - Route tasks to different API keys/providers (personal, client, enterprise, local)
69
94
  - Automatic API selection based on project configuration
70
95
  - Automatic migration from plaintext to secure storage
71
96
 
@@ -173,34 +198,118 @@ brew install thinmanj/tap/claude-dev-cli
173
198
 
174
199
  ### Via pip
175
200
 
201
+ #### Basic Installation
202
+
203
+ Core dependencies only (includes unidiff for diff parsing):
204
+
176
205
  ```bash
177
- # Basic installation
178
206
  pip install claude-dev-cli
207
+ ```
179
208
 
180
- # With code generation support (PDF & URL input)
181
- pip install claude-dev-cli[generation]
209
+ Core dependencies:
210
+ - `anthropic>=0.18.0` - Claude API client
211
+ - `click>=8.1.0` - CLI framework
212
+ - `rich>=13.0.0` - Terminal formatting
213
+ - `pydantic>=2.0.0` - Data validation
214
+ - `keyring>=24.0.0` - Secure credential storage
215
+ - `cryptography>=41.0.0` - Encryption for secure storage
216
+ - `pyyaml>=6.0.0` - YAML configuration support
217
+ - `unidiff>=0.7.0` - Production-grade diff parsing
182
218
 
183
- # With TOON support (30-60% token reduction)
184
- pip install claude-dev-cli[toon]
219
+ #### With Optional Features
185
220
 
186
- # With all optional features
187
- pip install claude-dev-cli[generation,toon]
221
+ **Multi-Provider Support**:
222
+
223
+ ```bash
224
+ # OpenAI (GPT) support
225
+ pip install 'claude-dev-cli[openai]'
226
+
227
+ # Ollama (local/free) support
228
+ pip install 'claude-dev-cli[ollama]'
229
+
230
+ # All providers
231
+ pip install 'claude-dev-cli[all-providers]'
232
+ ```
233
+
234
+ **Code Generation Support** (PDF & URL input):
235
+
236
+ ```bash
237
+ pip install 'claude-dev-cli[generation]'
238
+ ```
239
+
240
+ Adds:
241
+ - `pypdf>=3.0.0` - PDF text extraction
242
+ - `requests>=2.28.0` - HTTP client for URL fetching
243
+ - `beautifulsoup4>=4.0.0` - HTML parsing
244
+
245
+ **TOON Format Support** (30-60% token reduction):
246
+
247
+ ```bash
248
+ pip install 'claude-dev-cli[toon]'
249
+ ```
250
+
251
+ Adds:
252
+ - `toon-format>=0.1.0` - TOON encoding/decoding
253
+
254
+ **Syntax Highlighting** (enhanced diff display):
255
+
256
+ ```bash
257
+ pip install 'claude-dev-cli[plugins]'
258
+ ```
259
+
260
+ Adds:
261
+ - `pygments>=2.0.0` - Syntax highlighting for diffs
262
+
263
+ **All Optional Features**:
264
+
265
+ ```bash
266
+ pip install 'claude-dev-cli[generation,toon,plugins]'
188
267
  ```
189
268
 
269
+ **Development Installation** (for contributors):
270
+
271
+ ```bash
272
+ pip install 'claude-dev-cli[dev]'
273
+ ```
274
+
275
+ Includes all optional features plus:
276
+ - `pytest>=7.0.0` - Testing framework
277
+ - `black>=23.0.0` - Code formatting
278
+ - `ruff>=0.1.0` - Linting
279
+ - `mypy>=1.0.0` - Type checking
280
+
190
281
  ### Via pipx (Recommended for CLI tools)
191
282
 
283
+ pipx provides isolated installations without affecting your system Python:
284
+
192
285
  ```bash
193
- # Isolated installation
286
+ # Basic installation
194
287
  pipx install claude-dev-cli
195
288
 
196
- # With code generation support
197
- pipx install claude-dev-cli[generation]
289
+ # With code generation support (PDF & URL)
290
+ pipx install 'claude-dev-cli[generation]'
198
291
 
199
- # With TOON support
200
- pipx install claude-dev-cli[toon]
292
+ # With TOON support (token reduction)
293
+ pipx install 'claude-dev-cli[toon]'
294
+
295
+ # With syntax highlighting
296
+ pipx install 'claude-dev-cli[plugins]'
201
297
 
202
298
  # With all optional features
203
- pipx install claude-dev-cli[generation,toon]
299
+ pipx install 'claude-dev-cli[generation,toon,plugins]'
300
+ ```
301
+
302
+ ### Upgrade Existing Installation
303
+
304
+ ```bash
305
+ # Upgrade via pip
306
+ pip install --upgrade claude-dev-cli
307
+
308
+ # Upgrade via pipx
309
+ pipx upgrade claude-dev-cli
310
+
311
+ # Upgrade via Homebrew
312
+ brew upgrade claude-dev-cli
204
313
  ```
205
314
 
206
315
  ## Quick Start
@@ -224,6 +333,78 @@ cdc config list
224
333
  cdc config migrate-keys
225
334
  ```
226
335
 
336
+ ### 1.1 Setup Ollama (Local/Free Alternative) - v0.16.0+
337
+
338
+ Run AI models locally with **zero cost** and full privacy using Ollama:
339
+
340
+ ```bash
341
+ # Install Ollama (one-time setup)
342
+ # macOS/Linux: Download from https://ollama.ai
343
+ # Or via Homebrew: brew install ollama
344
+
345
+ # Start Ollama server
346
+ ollama serve # Run in background or separate terminal
347
+
348
+ # Install Ollama support
349
+ pip install 'claude-dev-cli[ollama]'
350
+
351
+ # Configure local provider (no API key needed!)
352
+ cdc config add ollama local --default
353
+ # ℹ️ No API key needed for local provider
354
+
355
+ # Pull models (one-time per model)
356
+ cdc ollama pull mistral # Fast, general-purpose (7B)
357
+ cdc ollama pull codellama # Code-specialized (7B-34B)
358
+ cdc ollama pull mixtral # Powerful reasoning (8x7B)
359
+
360
+ # List available models
361
+ cdc ollama list
362
+ # ┌──────────────┬─────────────────┬─────────┬──────────┬─────────────────┐
363
+ # │ Model │ Display Name │ Context │ Cost │ Capabilities │
364
+ # │ mistral │ Mistral 7B │ 8,192 │ FREE │ chat, code │
365
+ # │ codellama │ Code Llama │ 16,384 │ FREE │ code, chat │
366
+ # │ mixtral │ Mixtral 8x7B │ 32,768 │ FREE │ chat, analysis │
367
+ # └──────────────┴─────────────────┴─────────┴──────────┴─────────────────┘
368
+
369
+ # Show model details
370
+ cdc ollama show mistral
371
+ ```
372
+
373
+ **Benefits of Local Models:**
374
+ - ✅ **Zero Cost**: No API fees, unlimited usage
375
+ - ✅ **Privacy**: Data never leaves your machine
376
+ - ✅ **Offline**: Works without internet connection
377
+ - ✅ **Fast**: No API latency (after model loads)
378
+ - ✅ **Control**: Full control over models and data
379
+
380
+ **Considerations:**
381
+ - ⚠️ Requires decent hardware (8GB+ RAM, GPU recommended)
382
+ - ⚠️ Models need disk space (4-40GB per model)
383
+ - ⚠️ Quality may be lower than GPT-4/Claude Opus
384
+ - ⚠️ Initial model download can take time
385
+
386
+ **Use Local Models:**
387
+ ```bash
388
+ # Use with any command - completely FREE!
389
+ cdc ask "explain async/await"
390
+ cdc ask -m fast-local "quick question"
391
+ cdc generate tests -m code-local mymodule.py
392
+ cdc review -m smart-local src/
393
+
394
+ # Use specific model directly
395
+ cdc ask -m mistral "your question"
396
+ cdc ask -m codellama "write a function to parse JSON"
397
+
398
+ # Remote Ollama server
399
+ cdc config add ollama remote --base-url http://server:11434
400
+ cdc ask -a remote "question"
401
+ ```
402
+
403
+ **Available Model Profiles:**
404
+ - `fast-local`: mistral (8k context, fast inference)
405
+ - `smart-local`: mixtral (32k context, powerful)
406
+ - `code-local`: codellama (16k context, code-focused)
407
+
227
408
  ### 2. Basic Usage
228
409
 
229
410
  ```bash
@@ -11,9 +11,25 @@ A powerful command-line tool for developers using Claude AI with multi-API routi
11
11
 
12
12
  ## Features
13
13
 
14
+ ### 🌐 Multi-Provider AI Support (v0.14.0+)
15
+ - **Anthropic (Claude)**: GPT-4 class models with 200k context
16
+ - Haiku, Sonnet, Opus - full model family
17
+ - Industry-leading context window
18
+ - **OpenAI (GPT)**: ChatGPT and GPT-4 models (v0.15.0+)
19
+ - GPT-3.5 Turbo, GPT-4, GPT-4 Turbo
20
+ - Azure OpenAI support
21
+ - Install: `pip install 'claude-dev-cli[openai]'`
22
+ - **Ollama (Local)**: Zero-cost local inference (v0.16.0+)
23
+ - Mistral, Mixtral, Code Llama, DeepSeek Coder
24
+ - 100% free, private, offline
25
+ - Install: `pip install 'claude-dev-cli[ollama]'`
26
+ - **Provider Abstraction**: Unified interface across all providers
27
+ - **Cost Tracking**: Per-provider usage and cost monitoring
28
+ - **Graceful Fallback**: Works with any combination of providers
29
+
14
30
  ### 🔑 Multi-API Key Management
15
31
  - **Secure Storage**: API keys stored in system keyring (macOS Keychain, Linux Secret Service, Windows Credential Locker)
16
- - Route tasks to different Claude API keys (personal, client, enterprise)
32
+ - Route tasks to different API keys/providers (personal, client, enterprise, local)
17
33
  - Automatic API selection based on project configuration
18
34
  - Automatic migration from plaintext to secure storage
19
35
 
@@ -121,34 +137,118 @@ brew install thinmanj/tap/claude-dev-cli
121
137
 
122
138
  ### Via pip
123
139
 
140
+ #### Basic Installation
141
+
142
+ Core dependencies only (includes unidiff for diff parsing):
143
+
124
144
  ```bash
125
- # Basic installation
126
145
  pip install claude-dev-cli
146
+ ```
127
147
 
128
- # With code generation support (PDF & URL input)
129
- pip install claude-dev-cli[generation]
148
+ Core dependencies:
149
+ - `anthropic>=0.18.0` - Claude API client
150
+ - `click>=8.1.0` - CLI framework
151
+ - `rich>=13.0.0` - Terminal formatting
152
+ - `pydantic>=2.0.0` - Data validation
153
+ - `keyring>=24.0.0` - Secure credential storage
154
+ - `cryptography>=41.0.0` - Encryption for secure storage
155
+ - `pyyaml>=6.0.0` - YAML configuration support
156
+ - `unidiff>=0.7.0` - Production-grade diff parsing
130
157
 
131
- # With TOON support (30-60% token reduction)
132
- pip install claude-dev-cli[toon]
158
+ #### With Optional Features
133
159
 
134
- # With all optional features
135
- pip install claude-dev-cli[generation,toon]
160
+ **Multi-Provider Support**:
161
+
162
+ ```bash
163
+ # OpenAI (GPT) support
164
+ pip install 'claude-dev-cli[openai]'
165
+
166
+ # Ollama (local/free) support
167
+ pip install 'claude-dev-cli[ollama]'
168
+
169
+ # All providers
170
+ pip install 'claude-dev-cli[all-providers]'
171
+ ```
172
+
173
+ **Code Generation Support** (PDF & URL input):
174
+
175
+ ```bash
176
+ pip install 'claude-dev-cli[generation]'
177
+ ```
178
+
179
+ Adds:
180
+ - `pypdf>=3.0.0` - PDF text extraction
181
+ - `requests>=2.28.0` - HTTP client for URL fetching
182
+ - `beautifulsoup4>=4.0.0` - HTML parsing
183
+
184
+ **TOON Format Support** (30-60% token reduction):
185
+
186
+ ```bash
187
+ pip install 'claude-dev-cli[toon]'
188
+ ```
189
+
190
+ Adds:
191
+ - `toon-format>=0.1.0` - TOON encoding/decoding
192
+
193
+ **Syntax Highlighting** (enhanced diff display):
194
+
195
+ ```bash
196
+ pip install 'claude-dev-cli[plugins]'
197
+ ```
198
+
199
+ Adds:
200
+ - `pygments>=2.0.0` - Syntax highlighting for diffs
201
+
202
+ **All Optional Features**:
203
+
204
+ ```bash
205
+ pip install 'claude-dev-cli[generation,toon,plugins]'
136
206
  ```
137
207
 
208
+ **Development Installation** (for contributors):
209
+
210
+ ```bash
211
+ pip install 'claude-dev-cli[dev]'
212
+ ```
213
+
214
+ Includes all optional features plus:
215
+ - `pytest>=7.0.0` - Testing framework
216
+ - `black>=23.0.0` - Code formatting
217
+ - `ruff>=0.1.0` - Linting
218
+ - `mypy>=1.0.0` - Type checking
219
+
138
220
  ### Via pipx (Recommended for CLI tools)
139
221
 
222
+ pipx provides isolated installations without affecting your system Python:
223
+
140
224
  ```bash
141
- # Isolated installation
225
+ # Basic installation
142
226
  pipx install claude-dev-cli
143
227
 
144
- # With code generation support
145
- pipx install claude-dev-cli[generation]
228
+ # With code generation support (PDF & URL)
229
+ pipx install 'claude-dev-cli[generation]'
146
230
 
147
- # With TOON support
148
- pipx install claude-dev-cli[toon]
231
+ # With TOON support (token reduction)
232
+ pipx install 'claude-dev-cli[toon]'
233
+
234
+ # With syntax highlighting
235
+ pipx install 'claude-dev-cli[plugins]'
149
236
 
150
237
  # With all optional features
151
- pipx install claude-dev-cli[generation,toon]
238
+ pipx install 'claude-dev-cli[generation,toon,plugins]'
239
+ ```
240
+
241
+ ### Upgrade Existing Installation
242
+
243
+ ```bash
244
+ # Upgrade via pip
245
+ pip install --upgrade claude-dev-cli
246
+
247
+ # Upgrade via pipx
248
+ pipx upgrade claude-dev-cli
249
+
250
+ # Upgrade via Homebrew
251
+ brew upgrade claude-dev-cli
152
252
  ```
153
253
 
154
254
  ## Quick Start
@@ -172,6 +272,78 @@ cdc config list
172
272
  cdc config migrate-keys
173
273
  ```
174
274
 
275
+ ### 1.1 Setup Ollama (Local/Free Alternative) - v0.16.0+
276
+
277
+ Run AI models locally with **zero cost** and full privacy using Ollama:
278
+
279
+ ```bash
280
+ # Install Ollama (one-time setup)
281
+ # macOS/Linux: Download from https://ollama.ai
282
+ # Or via Homebrew: brew install ollama
283
+
284
+ # Start Ollama server
285
+ ollama serve # Run in background or separate terminal
286
+
287
+ # Install Ollama support
288
+ pip install 'claude-dev-cli[ollama]'
289
+
290
+ # Configure local provider (no API key needed!)
291
+ cdc config add ollama local --default
292
+ # ℹ️ No API key needed for local provider
293
+
294
+ # Pull models (one-time per model)
295
+ cdc ollama pull mistral # Fast, general-purpose (7B)
296
+ cdc ollama pull codellama # Code-specialized (7B-34B)
297
+ cdc ollama pull mixtral # Powerful reasoning (8x7B)
298
+
299
+ # List available models
300
+ cdc ollama list
301
+ # ┌──────────────┬─────────────────┬─────────┬──────────┬─────────────────┐
302
+ # │ Model │ Display Name │ Context │ Cost │ Capabilities │
303
+ # │ mistral │ Mistral 7B │ 8,192 │ FREE │ chat, code │
304
+ # │ codellama │ Code Llama │ 16,384 │ FREE │ code, chat │
305
+ # │ mixtral │ Mixtral 8x7B │ 32,768 │ FREE │ chat, analysis │
306
+ # └──────────────┴─────────────────┴─────────┴──────────┴─────────────────┘
307
+
308
+ # Show model details
309
+ cdc ollama show mistral
310
+ ```
311
+
312
+ **Benefits of Local Models:**
313
+ - ✅ **Zero Cost**: No API fees, unlimited usage
314
+ - ✅ **Privacy**: Data never leaves your machine
315
+ - ✅ **Offline**: Works without internet connection
316
+ - ✅ **Fast**: No API latency (after model loads)
317
+ - ✅ **Control**: Full control over models and data
318
+
319
+ **Considerations:**
320
+ - ⚠️ Requires decent hardware (8GB+ RAM, GPU recommended)
321
+ - ⚠️ Models need disk space (4-40GB per model)
322
+ - ⚠️ Quality may be lower than GPT-4/Claude Opus
323
+ - ⚠️ Initial model download can take time
324
+
325
+ **Use Local Models:**
326
+ ```bash
327
+ # Use with any command - completely FREE!
328
+ cdc ask "explain async/await"
329
+ cdc ask -m fast-local "quick question"
330
+ cdc generate tests -m code-local mymodule.py
331
+ cdc review -m smart-local src/
332
+
333
+ # Use specific model directly
334
+ cdc ask -m mistral "your question"
335
+ cdc ask -m codellama "write a function to parse JSON"
336
+
337
+ # Remote Ollama server
338
+ cdc config add ollama remote --base-url http://server:11434
339
+ cdc ask -a remote "question"
340
+ ```
341
+
342
+ **Available Model Profiles:**
343
+ - `fast-local`: mistral (8k context, fast inference)
344
+ - `smart-local`: mixtral (32k context, powerful)
345
+ - `code-local`: codellama (16k context, code-focused)
346
+
175
347
  ### 2. Basic Usage
176
348
 
177
349
  ```bash
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "claude-dev-cli"
7
- version = "0.13.3"
7
+ version = "0.16.1"
8
8
  description = "A powerful CLI tool for developers using Claude AI with multi-API routing, test generation, code review, and usage tracking"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.9"
@@ -50,6 +50,19 @@ generation = [
50
50
  "requests>=2.28.0",
51
51
  "beautifulsoup4>=4.0.0",
52
52
  ]
53
+ openai = [
54
+ "openai>=1.0.0",
55
+ ]
56
+ ollama = [
57
+ "requests>=2.28.0",
58
+ ]
59
+ local = [
60
+ "requests>=2.28.0",
61
+ ]
62
+ all-providers = [
63
+ "openai>=1.0.0",
64
+ "requests>=2.28.0",
65
+ ]
53
66
  dev = [
54
67
  "pytest>=7.0.0",
55
68
  "black>=23.0.0",
@@ -9,7 +9,7 @@ Features:
9
9
  - Interactive and single-shot modes
10
10
  """
11
11
 
12
- __version__ = "0.13.3"
12
+ __version__ = "0.16.1"
13
13
  __author__ = "Julio"
14
14
  __license__ = "MIT"
15
15