claude-dev-cli 0.8.1__tar.gz → 0.8.3__tar.gz

{claude_dev_cli-0.8.1/src/claude_dev_cli.egg-info → claude_dev_cli-0.8.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-dev-cli
-Version: 0.8.1
+Version: 0.8.3
 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
@@ -44,6 +44,13 @@ Dynamic: license-file
 
 # Claude Dev CLI
 
+[![PyPI version](https://badge.fury.io/py/claude-dev-cli.svg)](https://badge.fury.io/py/claude-dev-cli)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![Tests](https://img.shields.io/badge/tests-257%20passing-brightgreen.svg)](https://github.com/thinmanj/claude-dev-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Homebrew](https://img.shields.io/badge/homebrew-available-orange.svg)](https://github.com/thinmanj/homebrew-tap)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
 A powerful command-line tool for developers using Claude AI with multi-API routing, test generation, code review, and comprehensive usage tracking.
 
 ## Features
@@ -85,7 +92,8 @@ A powerful command-line tool for developers using Claude AI with multi-API routi
   - `git commit`, `generate tests`, `generate docs` (v0.8.1)
 - **Git Integration**: Automatically include branch, commits, modified files
 - **Dependency Analysis**: Parse imports and include related files
-- **Error Parsing**: Structured Python traceback parsing
+- **Multi-Language Error Parsing** (v0.8.2): Python, JavaScript/TypeScript, Go, Rust, Java
+- **Context Summary** (v0.8.2): Preview context before API calls with `cdc context summary`
 - **Smart Truncation**: Prevent token limits with configurable file size limits
 - **Project Memory**: Remember preferences per project
 - **Global Config**: Set context defaults in `~/.claude-dev-cli/config.json`
@@ -98,19 +106,39 @@ A powerful command-line tool for developers using Claude AI with multi-API routi
 
 ## Installation
 
-### Basic Installation
+### Via Homebrew (macOS/Linux)
 
 ```bash
-pip install claude-dev-cli
+# Add the tap
+brew tap thinmanj/tap
+
+# Install
+brew install claude-dev-cli
+
+# Or in one command
+brew install thinmanj/tap/claude-dev-cli
 ```
 
-### With TOON Support (Recommended for Cost Savings)
+### Via pip
 
 ```bash
-# Install with TOON format support for 30-60% token reduction
+# Basic installation
+pip install claude-dev-cli
+
+# With TOON support (30-60% token reduction)
 pip install claude-dev-cli[toon]
 ```
 
+### Via pipx (Recommended for CLI tools)
+
+```bash
+# Isolated installation
+pipx install claude-dev-cli
+
+# With TOON support
+pipx install claude-dev-cli[toon]
+```
+
 ## Quick Start
 
 ### 1. Set Up API Keys
@@ -199,7 +227,7 @@ git add .
 cdc git commit --auto-context
 ```
 
-### 4. Context-Aware Operations (NEW in v0.8.0)
+### 4. Context-Aware Operations (v0.8.0+)
 
 ```bash
 # Auto-context includes: git info, dependencies, related files
@@ -208,9 +236,16 @@ cdc git commit --auto-context
 cdc review mymodule.py --auto-context
 # ✓ Context gathered (git, dependencies, tests)
 
-# Debug with parsed error details
+# Debug with parsed error details (multi-language support)
 python broken.py 2>&1 | cdc debug -f broken.py --auto-context
+node app.js 2>&1 | cdc debug --auto-context  # JavaScript/TypeScript
+go run main.go 2>&1 | cdc debug --auto-context  # Go
 # ✓ Context gathered (error details, git context)
+# Supports: Python, JavaScript, TypeScript, Go, Rust, Java
+
+# Preview context before making API calls - NEW in v0.8.2
+cdc context summary mymodule.py
+# Shows: files, sizes, lines, estimated tokens, truncation warnings
 
 # Ask questions with file context
 cdc ask -f mycode.py --auto-context "how can I improve this?"
@@ -258,7 +293,33 @@ cdc template list --user
 - **explain-code**: Detailed code explanation
 - **api-design**: API design assistance
 
-### 6. Usage Tracking
+### 6. Conversation History & Summarization (NEW in v0.8.3)
+
+```bash
+# List recent conversations
+cdc history list
+
+# Search conversations
+cdc history list --search "python decorators"
+
+# Export conversation
+cdc history export 20240109_143022 -o chat.md
+
+# Summarize to reduce token usage
+cdc history summarize --latest
+cdc history summarize 20240109_143022 --keep-recent 6
+
+# Delete old conversations
+cdc history delete 20240109_143022
+```
+
+**Auto-Summarization** in interactive mode:
+- Automatically triggers when conversation exceeds 8,000 tokens
+- Keeps recent messages (default: 4 pairs), summarizes older ones
+- Reduces API costs by ~30-50% in long conversations
+- Shows token savings after summarization
+
+### 7. Usage Tracking
 
 ```bash
 # View all usage

{claude_dev_cli-0.8.1 → claude_dev_cli-0.8.3}/README.md

@@ -1,5 +1,12 @@
 # Claude Dev CLI
 
+[![PyPI version](https://badge.fury.io/py/claude-dev-cli.svg)](https://badge.fury.io/py/claude-dev-cli)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![Tests](https://img.shields.io/badge/tests-257%20passing-brightgreen.svg)](https://github.com/thinmanj/claude-dev-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Homebrew](https://img.shields.io/badge/homebrew-available-orange.svg)](https://github.com/thinmanj/homebrew-tap)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
 A powerful command-line tool for developers using Claude AI with multi-API routing, test generation, code review, and comprehensive usage tracking.
 
 ## Features
@@ -41,7 +48,8 @@ A powerful command-line tool for developers using Claude AI with multi-API routi
   - `git commit`, `generate tests`, `generate docs` (v0.8.1)
 - **Git Integration**: Automatically include branch, commits, modified files
 - **Dependency Analysis**: Parse imports and include related files
-- **Error Parsing**: Structured Python traceback parsing
+- **Multi-Language Error Parsing** (v0.8.2): Python, JavaScript/TypeScript, Go, Rust, Java
+- **Context Summary** (v0.8.2): Preview context before API calls with `cdc context summary`
 - **Smart Truncation**: Prevent token limits with configurable file size limits
 - **Project Memory**: Remember preferences per project
 - **Global Config**: Set context defaults in `~/.claude-dev-cli/config.json`
@@ -54,19 +62,39 @@ A powerful command-line tool for developers using Claude AI with multi-API routi
 
 ## Installation
 
-### Basic Installation
+### Via Homebrew (macOS/Linux)
 
 ```bash
-pip install claude-dev-cli
+# Add the tap
+brew tap thinmanj/tap
+
+# Install
+brew install claude-dev-cli
+
+# Or in one command
+brew install thinmanj/tap/claude-dev-cli
 ```
 
-### With TOON Support (Recommended for Cost Savings)
+### Via pip
 
 ```bash
-# Install with TOON format support for 30-60% token reduction
+# Basic installation
+pip install claude-dev-cli
+
+# With TOON support (30-60% token reduction)
 pip install claude-dev-cli[toon]
 ```
 
+### Via pipx (Recommended for CLI tools)
+
+```bash
+# Isolated installation
+pipx install claude-dev-cli
+
+# With TOON support
+pipx install claude-dev-cli[toon]
+```
+
 ## Quick Start
 
 ### 1. Set Up API Keys
@@ -155,7 +183,7 @@ git add .
 cdc git commit --auto-context
 ```
 
-### 4. Context-Aware Operations (NEW in v0.8.0)
+### 4. Context-Aware Operations (v0.8.0+)
 
 ```bash
 # Auto-context includes: git info, dependencies, related files
@@ -164,9 +192,16 @@ cdc git commit --auto-context
 cdc review mymodule.py --auto-context
 # ✓ Context gathered (git, dependencies, tests)
 
-# Debug with parsed error details
+# Debug with parsed error details (multi-language support)
 python broken.py 2>&1 | cdc debug -f broken.py --auto-context
+node app.js 2>&1 | cdc debug --auto-context  # JavaScript/TypeScript
+go run main.go 2>&1 | cdc debug --auto-context  # Go
 # ✓ Context gathered (error details, git context)
+# Supports: Python, JavaScript, TypeScript, Go, Rust, Java
+
+# Preview context before making API calls - NEW in v0.8.2
+cdc context summary mymodule.py
+# Shows: files, sizes, lines, estimated tokens, truncation warnings
 
 # Ask questions with file context
 cdc ask -f mycode.py --auto-context "how can I improve this?"
@@ -214,7 +249,33 @@ cdc template list --user
 - **explain-code**: Detailed code explanation
 - **api-design**: API design assistance
 
-### 6. Usage Tracking
+### 6. Conversation History & Summarization (NEW in v0.8.3)
+
+```bash
+# List recent conversations
+cdc history list
+
+# Search conversations
+cdc history list --search "python decorators"
+
+# Export conversation
+cdc history export 20240109_143022 -o chat.md
+
+# Summarize to reduce token usage
+cdc history summarize --latest
+cdc history summarize 20240109_143022 --keep-recent 6
+
+# Delete old conversations
+cdc history delete 20240109_143022
+```
+
+**Auto-Summarization** in interactive mode:
+- Automatically triggers when conversation exceeds 8,000 tokens
+- Keeps recent messages (default: 4 pairs), summarizes older ones
+- Reduces API costs by ~30-50% in long conversations
+- Shows token savings after summarization
+
+### 7. Usage Tracking
 
 ```bash
 # View all usage

{claude_dev_cli-0.8.1 → claude_dev_cli-0.8.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-dev-cli"
-version = "0.8.1"
+version = "0.8.3"
 description = "A powerful CLI tool for developers using Claude AI with multi-API routing, test generation, code review, and usage tracking"
 readme = "README.md"
 requires-python = ">=3.9"

{claude_dev_cli-0.8.1 → claude_dev_cli-0.8.3}/src/claude_dev_cli/__init__.py

@@ -9,7 +9,7 @@ Features:
 - Interactive and single-shot modes
 """
 
-__version__ = "0.8.1"
+__version__ = "0.8.3"
 __author__ = "Julio"
 __license__ = "MIT"
 

{claude_dev_cli-0.8.1 → claude_dev_cli-0.8.3}/src/claude_dev_cli/cli.py

@@ -145,6 +145,7 @@ def interactive(
     config = Config()
     history_dir = config.config_dir / "history"
     conv_history = ConversationHistory(history_dir)
+    summ_config = config.get_summarization_config()
     
     # Load or create conversation
     if continue_conversation:
@@ -203,6 +204,42 @@ def interactive(
                 full_response = ''.join(response_buffer)
                 conversation.add_message("assistant", full_response)
                 
+                # Check if auto-summarization is needed
+                if summ_config.auto_summarize and conversation.should_summarize(threshold_tokens=summ_config.threshold_tokens):
+                    console.print("\n[yellow]⚠ Conversation getting long, summarizing older messages...[/yellow]")
+                    old_messages, recent_messages = conversation.compress_messages(keep_recent=summ_config.keep_recent_messages)
+                    
+                    if old_messages:
+                        # Build summary prompt
+                        conversation_text = []
+                        if conversation.summary:
+                            conversation_text.append(f"Previous summary:\n{conversation.summary}\n\n")
+                        
+                        conversation_text.append("Conversation to summarize:\n")
+                        for msg in old_messages:
+                            role_name = "User" if msg.role == "user" else "Assistant"
+                            conversation_text.append(f"{role_name}: {msg.content}\n")
+                        
+                        summary_prompt = (
+                            "Please provide a concise summary of this conversation that captures:"
+                            "\n1. Main topics discussed"
+                            "\n2. Key questions asked and answers provided"
+                            "\n3. Important decisions or conclusions"
+                            "\n4. Any action items or follow-ups mentioned"
+                            "\n\nKeep the summary under 300 words but retain all important context."
+                            "\n\n" + "".join(conversation_text)
+                        )
+                        
+                        # Get summary (use same client)
+                        new_summary = client.call(summary_prompt)
+                        
+                        # Update conversation
+                        conversation.summary = new_summary
+                        conversation.messages = recent_messages
+                        
+                        tokens_saved = len("".join(conversation_text)) // 4
+                        console.print(f"[dim]✓ Summarized older messages (~{tokens_saved:,} tokens saved)[/dim]")
+                
                 # Auto-save periodically
                 if save and len(conversation.messages) % 10 == 0:
                     conv_history.save_conversation(conversation)
@@ -341,6 +378,100 @@ def history_export(ctx: click.Context, conversation_id: str, format: str, output
         click.echo(content)
 
 
+@history.command('summarize')
+@click.argument('conversation_id', required=False)
+@click.option('--keep-recent', type=int, default=4, help='Number of recent message pairs to keep')
+@click.option('--latest', is_flag=True, help='Summarize the latest conversation')
+@click.pass_context
+def history_summarize(
+    ctx: click.Context, 
+    conversation_id: Optional[str], 
+    keep_recent: int,
+    latest: bool
+) -> None:
+    """Summarize a conversation to reduce token usage.
+    
+    Older messages are compressed into an AI-generated summary while keeping
+    recent messages intact. This reduces context window usage and costs.
+    
+    Examples:
+        cdc history summarize 20240109_143022
+        cdc history summarize --latest
+        cdc history summarize --latest --keep-recent 6
+    """
+    console = ctx.obj['console']
+    config = Config()
+    conv_history = ConversationHistory(config.config_dir / "history")
+    
+    # Determine which conversation to summarize
+    if latest:
+        conv = conv_history.get_latest_conversation()
+        if not conv:
+            console.print("[red]No conversations found[/red]")
+            sys.exit(1)
+        conversation_id = conv.conversation_id
+    elif not conversation_id:
+        console.print("[red]Error: Provide conversation_id or use --latest[/red]")
+        console.print("\nUsage: cdc history summarize CONVERSATION_ID")
+        console.print("   or: cdc history summarize --latest")
+        sys.exit(1)
+    
+    # Load conversation to show stats
+    conv = conv_history.load_conversation(conversation_id)
+    if not conv:
+        console.print(f"[red]Conversation {conversation_id} not found[/red]")
+        sys.exit(1)
+    
+    # Show before stats
+    tokens_before = conv.estimate_tokens()
+    messages_before = len(conv.messages)
+    console.print(f"\n[cyan]Conversation:[/cyan] {conversation_id}")
+    console.print(f"[dim]Messages: {messages_before} | Estimated tokens: {tokens_before:,}[/dim]\n")
+    
+    if messages_before <= keep_recent:
+        console.print(f"[yellow]Too few messages to summarize ({messages_before} <= {keep_recent})[/yellow]")
+        return
+    
+    # Summarize
+    with console.status("[bold blue]Generating summary..."):
+        summary = conv_history.summarize_conversation(conversation_id, keep_recent)
+    
+    if not summary:
+        console.print("[red]Failed to generate summary[/red]")
+        sys.exit(1)
+    
+    # Reload and show after stats
+    conv = conv_history.load_conversation(conversation_id)
+    if conv:
+        tokens_after = conv.estimate_tokens()
+        messages_after = len(conv.messages)
+        
+        token_savings = tokens_before - tokens_after
+        savings_percent = (token_savings / tokens_before * 100) if tokens_before > 0 else 0
+        
+        console.print("[green]✓ Conversation summarized[/green]\n")
+        console.print(f"[dim]Messages:[/dim] {messages_before} → {messages_after}")
+        console.print(f"[dim]Tokens:[/dim] {tokens_before:,} → {tokens_after:,} ({token_savings:,} saved, {savings_percent:.1f}%)\n")
+        console.print("[bold]Summary:[/bold]")
+        console.print(Panel(summary, border_style="blue"))
+
+
+@history.command('delete')
+@click.argument('conversation_id')
+@click.pass_context
+def history_delete(ctx: click.Context, conversation_id: str) -> None:
+    """Delete a conversation."""
+    console = ctx.obj['console']
+    config = Config()
+    conv_history = ConversationHistory(config.config_dir / "history")
+    
+    if conv_history.delete_conversation(conversation_id):
+        console.print(f"[green]✓[/green] Deleted conversation: {conversation_id}")
+    else:
+        console.print(f"[red]Conversation {conversation_id} not found[/red]")
+        sys.exit(1)
+
+
 @main.group()
 def config() -> None:
     """Manage configuration."""
@@ -884,6 +1015,107 @@ def git_commit(ctx: click.Context, api: Optional[str], auto_context: bool) -> No
         sys.exit(1)
 
 
+@main.group()
+def context() -> None:
+    """Context gathering tools and information."""
+    pass
+
+
+@context.command('summary')
+@click.argument('file_path', type=click.Path(exists=True))
+@click.option('--include-git/--no-git', default=True, help='Include git context')
+@click.option('--include-deps/--no-deps', default=True, help='Include dependencies')
+@click.option('--include-tests/--no-tests', default=True, help='Include test files')
+@click.pass_context
+def context_summary(
+    ctx: click.Context,
+    file_path: str,
+    include_git: bool,
+    include_deps: bool,
+    include_tests: bool
+) -> None:
+    """Show what context would be gathered for a file."""
+    from claude_dev_cli.context import ContextGatherer
+    from rich.table import Table
+    
+    console = ctx.obj['console']
+    
+    try:
+        file_path_obj = Path(file_path)
+        gatherer = ContextGatherer()
+        
+        # Gather context
+        with console.status("[bold blue]Analyzing context..."):
+            context = gatherer.gather_for_review(
+                file_path_obj,
+                include_git=include_git,
+                include_tests=include_tests
+            )
+        
+        # Display summary
+        console.print(f"\n[bold cyan]Context Summary for:[/bold cyan] {file_path}\n")
+        
+        table = Table(show_header=True, header_style="bold magenta")
+        table.add_column("Type", style="cyan")
+        table.add_column("Content", style="white")
+        table.add_column("Size", justify="right", style="yellow")
+        table.add_column("Lines", justify="right", style="green")
+        table.add_column("Truncated", justify="center", style="red")
+        
+        total_chars = 0
+        total_lines = 0
+        
+        for item in context.items:
+            lines = len(item.content.split('\n'))
+            chars = len(item.content)
+            truncated = "✓" if item.metadata.get('truncated') else ""
+            
+            # Format content preview
+            if item.type == 'file':
+                content = item.metadata.get('path', 'unknown')
+                if item.metadata.get('is_test'):
+                    content += " [TEST]"
+            elif item.type == 'git':
+                branch = item.metadata.get('branch', 'unknown')
+                modified = item.metadata.get('modified_count', 0)
+                content = f"Branch: {branch}, {modified} modified files"
+            elif item.type == 'dependency':
+                dep_files = item.metadata.get('dependency_files', [])
+                content = f"{len(dep_files)} dependency files"
+            else:
+                content = item.type
+            
+            table.add_row(
+                item.type.title(),
+                content[:60] + "..." if len(content) > 60 else content,
+                f"{chars:,}",
+                f"{lines:,}",
+                truncated
+            )
+            
+            total_chars += chars
+            total_lines += lines
+        
+        console.print(table)
+        
+        # Show totals
+        console.print(f"\n[bold]Total:[/bold]")
+        console.print(f"  Characters: [yellow]{total_chars:,}[/yellow]")
+        console.print(f"  Lines: [green]{total_lines:,}[/green]")
+        console.print(f"  Estimated tokens: [cyan]~{total_chars // 4:,}[/cyan] (rough estimate)")
+        
+        # Show any truncation warnings
+        truncated_items = [item for item in context.items if item.metadata.get('truncated')]
+        if truncated_items:
+            console.print(f"\n[yellow]⚠ {len(truncated_items)} item(s) truncated to fit size limits[/yellow]")
+        
+        console.print(f"\n[dim]Use --auto-context with commands to include this context[/dim]")
+    
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        sys.exit(1)
+
+
 @main.command('usage')
 @click.option('--days', type=int, help='Filter by days')
 @click.option('--api', help='Filter by API config')

{claude_dev_cli-0.8.1 → claude_dev_cli-0.8.3}/src/claude_dev_cli/config.py

@@ -21,6 +21,15 @@ class ContextConfig(BaseModel):
     include_tests: bool = True  # Include test files by default
 
 
+class SummarizationConfig(BaseModel):
+    """Conversation summarization configuration."""
+    
+    auto_summarize: bool = True  # Enable automatic summarization
+    threshold_tokens: int = 8000  # Token threshold for auto-summarization
+    keep_recent_messages: int = 4  # Number of recent message pairs to keep
+    summary_max_words: int = 300  # Maximum words in generated summary
+
+
 class APIConfig(BaseModel):
     """Configuration for a Claude API key."""
     
@@ -87,6 +96,7 @@ class Config:
                 "default_model": "claude-3-5-sonnet-20241022",
                 "max_tokens": 4096,
                 "context": ContextConfig().model_dump(),
+                "summarization": SummarizationConfig().model_dump(),
             }
             self._save_config(default_config)
             return default_config
@@ -263,3 +273,8 @@ class Config:
         """Get context gathering configuration."""
         context_data = self._data.get("context", {})
         return ContextConfig(**context_data) if context_data else ContextConfig()
+    
+    def get_summarization_config(self) -> SummarizationConfig:
+        """Get conversation summarization configuration."""
+        summ_data = self._data.get("summarization", {})
+        return SummarizationConfig(**summ_data) if summ_data else SummarizationConfig()