claude-dev-cli 0.1.0__tar.gz

claude_dev_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Julio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

claude_dev_cli-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include src/claude_dev_cli/templates *.txt

claude_dev_cli-0.1.0/PKG-INFO

@@ -0,0 +1,392 @@
+Metadata-Version: 2.4
+Name: claude-dev-cli
+Version: 0.1.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
+Project-URL: Homepage, https://github.com/thinmanj/claude-dev-cli
+Project-URL: Repository, https://github.com/thinmanj/claude-dev-cli
+Project-URL: Issues, https://github.com/thinmanj/claude-dev-cli/issues
+Keywords: claude,ai,cli,development,testing,code-review,anthropic
+Classifier: Development Status :: 4 - Beta
+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
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: anthropic>=0.18.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# Claude Dev CLI
+
+A powerful command-line tool for developers using Claude AI with multi-API routing, test generation, code review, and comprehensive usage tracking.
+
+## Features
+
+### 🔑 Multi-API Key Management
+- Route tasks to different Claude API keys (personal, client, enterprise)
+- Automatic API selection based on project configuration
+- Environment variable support for secure key management
+
+### 🧪 Developer Tools
+- **Test Generation**: Automatic pytest test generation for Python code
+- **Code Review**: Comprehensive code reviews with security, performance, and best practice checks
+- **Debug Assistant**: Analyze errors and get fixes with explanations
+- **Documentation**: Generate docstrings and README documentation
+- **Refactoring**: Get suggestions for code improvements
+- **Git Integration**: Generate conventional commit messages from diffs
+
+### 📊 Usage Tracking
+- Track token usage per API key
+- Cost estimation based on current pricing
+- Filter by date range and API config
+- Detailed breakdowns by model, date, and API
+
+### 💬 Interaction Modes
+- **Single-shot**: Quick questions with piping support
+- **Interactive**: Chat mode with conversation history
+- **Streaming**: Real-time responses
+
+## Installation
+
+```bash
+pip install claude-dev-cli
+```
+
+## Quick Start
+
+### 1. Set Up API Keys
+
+```bash
+# Add your personal API key
+export PERSONAL_ANTHROPIC_API_KEY="sk-ant-..."
+cdc config add personal --default --description "My personal API key"
+
+# Add client's API key
+export CLIENT_ANTHROPIC_API_KEY="sk-ant-..."
+cdc config add client --description "Client's Enterprise API"
+
+# List configured APIs
+cdc config list
+```
+
+### 2. Basic Usage
+
+```bash
+# Ask a question
+cdc ask "explain asyncio in Python"
+
+# With file context
+cdc ask -f mycode.py "review this code"
+
+# Pipe input
+cat error.log | cdc ask "what's causing this error?"
+
+# Interactive mode
+cdc interactive
+
+# Use specific API
+cdc ask -a client "generate tests for this function"
+```
+
+### 3. Developer Commands
+
+```bash
+# Generate tests
+cdc generate tests mymodule.py -o tests/test_mymodule.py
+
+# Code review
+cdc review mymodule.py
+
+# Debug errors
+python script.py 2>&1 | cdc debug
+
+# Generate documentation
+cdc generate docs mymodule.py
+
+# Refactor suggestions
+cdc refactor legacy_code.py
+
+# Git commit message
+git add .
+cdc git commit
+```
+
+### 4. Usage Tracking
+
+```bash
+# View all usage
+cdc usage
+
+# Last 7 days
+cdc usage --days 7
+
+# Filter by API
+cdc usage --api client
+```
+
+## Configuration
+
+### Global Configuration
+
+Configuration is stored in `~/.claude-dev-cli/config.json`:
+
+```json
+{
+  "api_configs": [
+    {
+      "name": "personal",
+      "api_key": "sk-ant-...",
+      "description": "My personal API key",
+      "default": true
+    },
+    {
+      "name": "client",
+      "api_key": "sk-ant-...",
+      "description": "Client's Enterprise API",
+      "default": false
+    }
+  ],
+  "default_model": "claude-3-5-sonnet-20241022",
+  "max_tokens": 4096
+}
+```
+
+### Project-Specific Configuration
+
+Create `.claude-dev-cli` in your project root:
+
+```json
+{
+  "name": "My Project",
+  "api_config": "client",
+  "system_prompt": "You are a Python expert focused on data science.",
+  "allowed_commands": ["all"]
+}
+```
+
+The tool will automatically use the client's API when you run commands in that project!
+
+## API Routing Strategy
+
+### Scenario: Client Work with Enterprise API
+
+```bash
+# 1. Set up client's API
+export CLIENT_ANTHROPIC_API_KEY="sk-ant-..."
+cdc config add client --description "Client Enterprise API"
+
+# 2. Create project config
+cd /path/to/client/project
+cat > .claude-dev-cli << 'EOF'
+{
+  "name": "Client Project",
+  "api_config": "client",
+  "system_prompt": "You are a senior Python developer."
+}
+EOF
+
+# 3. All commands in this directory now use client's API
+cdc generate tests app.py  # Uses client's API
+cdc review code.py         # Uses client's API
+
+# 4. Your personal projects use your API
+cd ~/my-personal-project
+cdc generate tests app.py  # Uses your personal API
+```
+
+## What the Client Can See
+
+When using a client's Enterprise API:
+
+✅ **They CAN see:**
+- Total API calls and token usage
+- Costs associated with the API key
+- Potentially conversation history (if enabled by admin)
+
+❌ **They CANNOT see:**
+- Which machine you used
+- Your other API keys or projects
+- Local files unless you sent the content
+
+## Command Reference
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `cdc ask <prompt>` | Ask Claude a question |
+| `cdc interactive` | Start interactive chat |
+| `cdc usage` | Show usage statistics |
+
+### Configuration
+
+| Command | Description |
+|---------|-------------|
+| `cdc config add <name>` | Add API configuration |
+| `cdc config list` | List all API configs |
+
+### Code Generation
+
+| Command | Description |
+|---------|-------------|
+| `cdc generate tests <file>` | Generate pytest tests |
+| `cdc generate docs <file>` | Generate documentation |
+
+### Code Analysis
+
+| Command | Description |
+|---------|-------------|
+| `cdc review <file>` | Review code |
+| `cdc debug -f <file> -e <error>` | Debug code |
+| `cdc refactor <file>` | Refactoring suggestions |
+
+### Git Helpers
+
+| Command | Description |
+|---------|-------------|
+| `cdc git commit` | Generate commit message |
+
+## Options
+
+### Common Options
+
+- `-a, --api <name>`: Use specific API config
+- `-m, --model <name>`: Use specific Claude model
+- `-s, --system <prompt>`: Set system prompt
+- `-f, --file <path>`: Include file in prompt
+- `-o, --output <path>`: Save output to file
+
+### Models
+
+- `claude-3-5-sonnet-20241022` (default)
+- `claude-3-opus-20240229`
+- `claude-3-haiku-20240307`
+
+## Examples
+
+### Test Generation
+
+```bash
+# Generate tests for a module
+cdc generate tests src/calculator.py -o tests/test_calculator.py
+
+# Review the tests
+cdc review tests/test_calculator.py
+```
+
+### Code Review Workflow
+
+```bash
+# Review before committing
+cdc review mycode.py
+
+# Fix issues, then generate commit message
+git add mycode.py
+cdc git commit
+```
+
+### Debugging
+
+```bash
+# Run script and analyze errors
+python buggy_script.py 2>&1 | cdc debug
+
+# Or debug a specific file
+cdc debug -f buggy_script.py -e "NameError: name 'x' is not defined"
+```
+
+### Using Multiple APIs
+
+```bash
+# Personal work
+cdc ask "explain decorators" -a personal
+
+# Client work
+cdc generate tests client_code.py -a client
+
+# Check usage per API
+cdc usage --api personal
+cdc usage --api client
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `{NAME}_ANTHROPIC_API_KEY` | API key for config named "name" |
+| `ANTHROPIC_API_KEY` | Default API key |
+
+## Usage Log Format
+
+Usage logs are stored in `~/.claude-dev-cli/usage.jsonl`:
+
+```json
+{
+  "timestamp": "2024-12-28T03:00:00.000000",
+  "api_config": "client",
+  "model": "claude-3-5-sonnet-20241022",
+  "prompt_preview": "Generate tests for...",
+  "input_tokens": 1523,
+  "output_tokens": 2847,
+  "duration_ms": 3421
+}
+```
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/thinmanj/claude-dev-cli
+cd claude-dev-cli
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Format code
+black src/
+ruff check src/
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Author
+
+Julio ([@thinmanj](https://github.com/thinmanj))
+
+## Acknowledgments
+
+- Built with [Anthropic's Claude API](https://www.anthropic.com/)
+- CLI powered by [Click](https://click.palletsprojects.com/)
+- Beautiful terminal output with [Rich](https://rich.readthedocs.io/)
+
+## Support
+
+- 🐛 [Report bugs](https://github.com/thinmanj/claude-dev-cli/issues)
+- 💡 [Request features](https://github.com/thinmanj/claude-dev-cli/issues)
+- 📖 [Documentation](https://github.com/thinmanj/claude-dev-cli)