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.
- {claude_dev_cli-0.13.3/src/claude_dev_cli.egg-info → claude_dev_cli-0.16.1}/PKG-INFO +196 -15
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/README.md +186 -14
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/pyproject.toml +14 -1
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/__init__.py +1 -1
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/cli.py +231 -13
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/config.py +95 -9
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/core.py +48 -53
- claude_dev_cli-0.16.1/src/claude_dev_cli/providers/__init__.py +28 -0
- claude_dev_cli-0.16.1/src/claude_dev_cli/providers/anthropic.py +216 -0
- claude_dev_cli-0.16.1/src/claude_dev_cli/providers/base.py +168 -0
- claude_dev_cli-0.16.1/src/claude_dev_cli/providers/factory.py +114 -0
- claude_dev_cli-0.16.1/src/claude_dev_cli/providers/ollama.py +283 -0
- claude_dev_cli-0.16.1/src/claude_dev_cli/providers/openai.py +268 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/workflows.py +49 -1
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1/src/claude_dev_cli.egg-info}/PKG-INFO +196 -15
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli.egg-info/SOURCES.txt +6 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli.egg-info/requires.txt +13 -0
- claude_dev_cli-0.16.1/tests/test_core.py +188 -0
- claude_dev_cli-0.13.3/tests/test_core.py +0 -241
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/LICENSE +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/MANIFEST.in +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/setup.cfg +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/commands.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/context.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/history.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/input_sources.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/multi_file_handler.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/path_utils.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/plugins/__init__.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/plugins/base.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/plugins/diff_editor/__init__.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/plugins/diff_editor/plugin.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/plugins/diff_editor/viewer.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/secure_storage.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/template_manager.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/templates.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/toon_utils.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/usage.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli/warp_integration.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli.egg-info/dependency_links.txt +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli.egg-info/entry_points.txt +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/src/claude_dev_cli.egg-info/top_level.txt +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_cli.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_commands.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_config.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_context.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_diff_editor.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_history.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_input_sources.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_multi_file_handler.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_path_utils.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_secure_storage.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_template_manager.py +0 -0
- {claude_dev_cli-0.13.3 → claude_dev_cli-0.16.1}/tests/test_toon_utils.py +0 -0
- {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.
|
|
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
|
|
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
|
-
|
|
181
|
-
|
|
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
|
-
|
|
184
|
-
pip install claude-dev-cli[toon]
|
|
219
|
+
#### With Optional Features
|
|
185
220
|
|
|
186
|
-
|
|
187
|
-
|
|
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
|
-
#
|
|
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
|
|
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
|
-
|
|
129
|
-
|
|
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
|
-
|
|
132
|
-
pip install claude-dev-cli[toon]
|
|
158
|
+
#### With Optional Features
|
|
133
159
|
|
|
134
|
-
|
|
135
|
-
|
|
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
|
-
#
|
|
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.
|
|
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",
|