claude-dev-cli 0.8.2__py3-none-any.whl → 0.8.3__py3-none-any.whl

claude_dev_cli/__init__.py

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

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."""

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()

claude_dev_cli/history.py

@@ -39,11 +39,13 @@ class Conversation:
         self,
         conversation_id: Optional[str] = None,
         created_at: Optional[datetime] = None,
-        updated_at: Optional[datetime] = None
+        updated_at: Optional[datetime] = None,
+        summary: Optional[str] = None
     ):
-        self.conversation_id = conversation_id or datetime.utcnow().strftime("%Y%m%d_%H%M%S")
+        self.conversation_id = conversation_id or datetime.utcnow().strftime("%Y%m%d_%H%M%S_%f")
         self.created_at = created_at or datetime.utcnow()
         self.updated_at = updated_at or datetime.utcnow()
+        self.summary = summary  # AI-generated summary of older messages
         self.messages: List[Message] = []
     
     def add_message(self, role: str, content: str) -> None:
@@ -62,14 +64,37 @@ class Conversation:
                 return summary
         return "(empty conversation)"
     
+    def estimate_tokens(self) -> int:
+        """Estimate token count for the conversation."""
+        # Rough estimation: ~4 characters per token
+        total_chars = len(self.summary or "")
+        for msg in self.messages:
+            total_chars += len(msg.content)
+        return total_chars // 4
+    
+    def should_summarize(self, threshold_tokens: int = 8000) -> bool:
+        """Check if conversation should be summarized."""
+        return self.estimate_tokens() > threshold_tokens and len(self.messages) > 4
+    
+    def compress_messages(self, keep_recent: int = 4) -> tuple[List[Message], List[Message]]:
+        """Split messages into old (to summarize) and recent (to keep)."""
+        if len(self.messages) <= keep_recent:
+            return [], self.messages
+        
+        split_point = len(self.messages) - keep_recent
+        return self.messages[:split_point], self.messages[split_point:]
+    
     def to_dict(self) -> Dict[str, Any]:
         """Convert to dictionary for storage."""
-        return {
+        data = {
             "conversation_id": self.conversation_id,
             "created_at": self.created_at.isoformat(),
             "updated_at": self.updated_at.isoformat(),
             "messages": [msg.to_dict() for msg in self.messages]
         }
+        if self.summary:
+            data["summary"] = self.summary
+        return data
     
     @classmethod
     def from_dict(cls, data: Dict[str, Any]) -> "Conversation":
@@ -77,7 +102,8 @@ class Conversation:
         conv = cls(
             conversation_id=data["conversation_id"],
             created_at=datetime.fromisoformat(data["created_at"]),
-            updated_at=datetime.fromisoformat(data["updated_at"])
+            updated_at=datetime.fromisoformat(data["updated_at"]),
+            summary=data.get("summary")
         )
         conv.messages = [Message.from_dict(msg) for msg in data.get("messages", [])]
         return conv
@@ -187,3 +213,63 @@ class ConversationHistory:
             return json.dumps(conv.to_dict(), indent=2)
         
         return None
+    
+    def summarize_conversation(
+        self,
+        conversation_id: str,
+        keep_recent: int = 4
+    ) -> Optional[str]:
+        """Summarize older messages in a conversation, keeping recent ones.
+        
+        Args:
+            conversation_id: The conversation to summarize
+            keep_recent: Number of recent message pairs to keep unsummarized
+            
+        Returns:
+            The generated summary or None if conversation not found
+        """
+        from claude_dev_cli.core import ClaudeClient
+        
+        conv = self.load_conversation(conversation_id)
+        if not conv:
+            return None
+        
+        # Split messages
+        old_messages, recent_messages = conv.compress_messages(keep_recent)
+        
+        if not old_messages:
+            return "No messages to summarize (too few messages)"
+        
+        # Build summary prompt
+        conversation_text = []
+        if conv.summary:
+            conversation_text.append(f"Previous summary:\n{conv.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")
+        
+        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 from Claude
+        client = ClaudeClient()
+        new_summary = client.call(prompt)
+        
+        # Update conversation
+        conv.summary = new_summary
+        conv.messages = recent_messages
+        conv.updated_at = datetime.utcnow()
+        
+        # Save updated conversation
+        self.save_conversation(conv)
+        
+        return new_summary

{claude_dev_cli-0.8.2.dist-info → claude_dev_cli-0.8.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-dev-cli
-Version: 0.8.2
+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
@@ -99,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
@@ -266,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.2.dist-info → claude_dev_cli-0.8.3.dist-info}/RECORD

@@ -1,10 +1,10 @@
-claude_dev_cli/__init__.py,sha256=zz-bOjjR01C_VWxFEsIWbdJui0kBuDLpDfJV7yAFFRc,469
-claude_dev_cli/cli.py,sha256=BjTST8JSd8quldFxs09ZzlAPGt-rFIYhKUCWfj1pIn4,55100
+claude_dev_cli/__init__.py,sha256=4-FONrbZl8GAHKPOWIDbvA7AmSZsTv8CRep1rwl1w5Y,469
+claude_dev_cli/cli.py,sha256=hy2HjU7oEWgGwNB7apBKFQmzjhYrxhHxTqtJ18iePZE,61164
 claude_dev_cli/commands.py,sha256=RKGx2rv56PM6eErvA2uoQ20hY8babuI5jav8nCUyUOk,3964
-claude_dev_cli/config.py,sha256=OLx0xWDf1RIK6RIxl5OKVS4aOSMZZOKxBDmzfQX-muk,9745
+claude_dev_cli/config.py,sha256=hisG91dUfDwuSdBhmYovU-rrGv__nFq-6fp7S288cSw,10471
 claude_dev_cli/context.py,sha256=1TlLzpREFZDEIuU7RAtlkjxARKWZpnxHHvK283sUAZE,26714
 claude_dev_cli/core.py,sha256=yaLjEixDvPzvUy4fJ2UB7nMpPPLyKACjR-RuM-1OQBY,4780
-claude_dev_cli/history.py,sha256=iQlqgTnXCsyCq5q-XaDl7V5MyPKQ3bx7o_k76-xWSAA,6863
+claude_dev_cli/history.py,sha256=v952xORhxZD0ayrrMaIbTLfe6kOW5fYryoeEmQLlQPg,10163
 claude_dev_cli/secure_storage.py,sha256=TK3WOaU7a0yTOtzdP_t_28fDRp2lovANNAC6MBdm4nQ,7096
 claude_dev_cli/template_manager.py,sha256=ZFXOtRIoB6hpf8kLSF9TWJfvUPJt9b-PyEv3qTBK7Zs,8600
 claude_dev_cli/templates.py,sha256=lKxH943ySfUKgyHaWa4W3LVv91SgznKgajRtSRp_4UY,2260
@@ -17,9 +17,9 @@ claude_dev_cli/plugins/base.py,sha256=H4HQet1I-a3WLCfE9F06Lp8NuFvVoIlou7sIgyJFK-
 claude_dev_cli/plugins/diff_editor/__init__.py,sha256=gqR5S2TyIVuq-sK107fegsutQ7Z-sgAIEbtc71FhXIM,101
 claude_dev_cli/plugins/diff_editor/plugin.py,sha256=M1bUoqpasD3ZNQo36Fu_8g92uySPZyG_ujMbj5UplsU,3073
 claude_dev_cli/plugins/diff_editor/viewer.py,sha256=1IOXIKw_01ppJx5C1dQt9Kr6U1TdAHT8_iUT5r_q0NM,17169
-claude_dev_cli-0.8.2.dist-info/licenses/LICENSE,sha256=DGueuJwMJtMwgLO5mWlS0TaeBrFwQuNpNZ22PU9J2bw,1062
-claude_dev_cli-0.8.2.dist-info/METADATA,sha256=4Pyai7Is7NJezxG5ypTm5rML1wEqIlOwHI5GZDlFFs0,15708
-claude_dev_cli-0.8.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-claude_dev_cli-0.8.2.dist-info/entry_points.txt,sha256=zymgUIIVpFTARkFmxAuW2A4BQsNITh_L0uU-XunytHg,85
-claude_dev_cli-0.8.2.dist-info/top_level.txt,sha256=m7MF6LOIuTe41IT5Fgt0lc-DK1EgM4gUU_IZwWxK0pg,15
-claude_dev_cli-0.8.2.dist-info/RECORD,,
+claude_dev_cli-0.8.3.dist-info/licenses/LICENSE,sha256=DGueuJwMJtMwgLO5mWlS0TaeBrFwQuNpNZ22PU9J2bw,1062
+claude_dev_cli-0.8.3.dist-info/METADATA,sha256=zgkMO_8g4hwJ7ccfDqGqXM-d3OfghrhxsWt7JK0evgs,17356
+claude_dev_cli-0.8.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+claude_dev_cli-0.8.3.dist-info/entry_points.txt,sha256=zymgUIIVpFTARkFmxAuW2A4BQsNITh_L0uU-XunytHg,85
+claude_dev_cli-0.8.3.dist-info/top_level.txt,sha256=m7MF6LOIuTe41IT5Fgt0lc-DK1EgM4gUU_IZwWxK0pg,15
+claude_dev_cli-0.8.3.dist-info/RECORD,,