claude-dev-cli 0.4.0__py3-none-any.whl → 0.6.0__py3-none-any.whl

claude_dev_cli/__init__.py

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

claude_dev_cli/cli.py

@@ -1,5 +1,6 @@
 """Command-line interface for Claude Dev CLI."""
 
+import os
 import sys
 from pathlib import Path
 from typing import Optional
@@ -23,6 +24,8 @@ from claude_dev_cli.commands import (
 from claude_dev_cli.usage import UsageTracker
 from claude_dev_cli import toon_utils
 from claude_dev_cli.plugins import load_plugins
+from claude_dev_cli.history import ConversationHistory, Conversation
+from claude_dev_cli.template_manager import TemplateManager, Template
 
 console = Console()
 
@@ -112,11 +115,36 @@ def ask(
 
 @main.command()
 @click.option('-a', '--api', help='API config to use')
+@click.option('--continue', 'continue_conversation', is_flag=True, 
+              help='Continue the last conversation')
+@click.option('--save/--no-save', default=True, help='Save conversation history')
 @click.pass_context
-def interactive(ctx: click.Context, api: Optional[str]) -> None:
+def interactive(
+    ctx: click.Context, 
+    api: Optional[str],
+    continue_conversation: bool,
+    save: bool
+) -> None:
     """Start interactive chat mode."""
     console = ctx.obj['console']
     
+    # Setup conversation history
+    config = Config()
+    history_dir = config.config_dir / "history"
+    conv_history = ConversationHistory(history_dir)
+    
+    # Load or create conversation
+    if continue_conversation:
+        conversation = conv_history.get_latest_conversation()
+        if conversation:
+            console.print(f"[green]↶ Continuing conversation from {conversation.updated_at.strftime('%Y-%m-%d %H:%M')}[/green]")
+            console.print(f"[dim]Messages: {len(conversation.messages)}[/dim]\n")
+        else:
+            console.print("[yellow]No previous conversation found, starting new one[/yellow]\n")
+            conversation = Conversation()
+    else:
+        conversation = Conversation()
+    
     console.print(Panel.fit(
         "Claude Dev CLI - Interactive Mode\n"
         "Type 'exit' or 'quit' to end\n"
@@ -127,28 +155,177 @@ def interactive(ctx: click.Context, api: Optional[str]) -> None:
     
     try:
         client = ClaudeClient(api_config_name=api)
+        response_buffer = []
         
         while True:
             try:
                 user_input = console.input("\n[bold cyan]You:[/bold cyan] ").strip()
                 
                 if user_input.lower() in ['exit', 'quit']:
+                    if save and conversation.messages:
+                        conv_history.save_conversation(conversation)
+                        console.print(f"\n[dim]💾 Saved conversation: {conversation.conversation_id}[/dim]")
                     break
+                
+                if user_input.lower() == 'clear':
+                    conversation = Conversation()
+                    console.print("[yellow]Conversation cleared[/yellow]")
+                    continue
+                
                 if not user_input:
                     continue
                 
+                # Add user message to history
+                conversation.add_message("user", user_input)
+                
+                # Get response
                 console.print("\n[bold green]Claude:[/bold green] ", end='')
+                response_buffer = []
                 for chunk in client.call_streaming(user_input):
                     console.print(chunk, end='')
+                    response_buffer.append(chunk)
                 console.print()
                 
+                # Add assistant response to history
+                full_response = ''.join(response_buffer)
+                conversation.add_message("assistant", full_response)
+                
+                # Auto-save periodically
+                if save and len(conversation.messages) % 10 == 0:
+                    conv_history.save_conversation(conversation)
+                
             except KeyboardInterrupt:
                 console.print("\n\n[yellow]Interrupted. Type 'exit' to quit.[/yellow]")
                 continue
     
     except Exception as e:
         console.print(f"[red]Error: {e}[/red]")
+        if save and conversation.messages:
+            conv_history.save_conversation(conversation)
+        sys.exit(1)
+
+
+@main.group()
+def completion() -> None:
+    """Shell completion installation."""
+    pass
+
+
+@completion.command('install')
+@click.option('--shell', type=click.Choice(['bash', 'zsh', 'fish', 'auto']), default='auto',
+              help='Shell type (auto-detects if not specified)')
+@click.pass_context
+def completion_install(ctx: click.Context, shell: str) -> None:
+    """Install shell completion for cdc command."""
+    console = ctx.obj['console']
+    
+    # Auto-detect shell if needed
+    if shell == 'auto':
+        shell_path = os.environ.get('SHELL', '')
+        if 'zsh' in shell_path:
+            shell = 'zsh'
+        elif 'bash' in shell_path:
+            shell = 'bash'
+        elif 'fish' in shell_path:
+            shell = 'fish'
+        else:
+            console.print("[red]Could not auto-detect shell[/red]")
+            console.print("Please specify: --shell bash|zsh|fish")
+            sys.exit(1)
+    
+    console.print(f"[cyan]Installing completion for {shell}...[/cyan]\n")
+    
+    if shell == 'zsh':
+        console.print("Add this to your ~/.zshrc:\n")
+        console.print("[yellow]eval \"$(_CDC_COMPLETE=zsh_source cdc)\"[/yellow]\n")
+        console.print("Then run: [cyan]source ~/.zshrc[/cyan]")
+    elif shell == 'bash':
+        console.print("Add this to your ~/.bashrc:\n")
+        console.print("[yellow]eval \"$(_CDC_COMPLETE=bash_source cdc)\"[/yellow]\n")
+        console.print("Then run: [cyan]source ~/.bashrc[/cyan]")
+    elif shell == 'fish':
+        console.print("Add this to ~/.config/fish/completions/cdc.fish:\n")
+        console.print("[yellow]_CDC_COMPLETE=fish_source cdc | source[/yellow]\n")
+        console.print("Then reload: [cyan]exec fish[/cyan]")
+    
+    console.print("\n[green]✓[/green] Instructions displayed above")
+    console.print("[dim]Completion will provide command and option suggestions[/dim]")
+
+
+@completion.command('generate')
+@click.option('--shell', type=click.Choice(['bash', 'zsh', 'fish']), required=True,
+              help='Shell type')
+@click.pass_context
+def completion_generate(ctx: click.Context, shell: str) -> None:
+    """Generate completion script for shell."""
+    import subprocess
+    import sys
+    
+    env_var = f"_CDC_COMPLETE={shell}_source"
+    result = subprocess.run(
+        [sys.executable, '-m', 'claude_dev_cli.cli'],
+        env={**os.environ, '_CDC_COMPLETE': f'{shell}_source'},
+        capture_output=True,
+        text=True
+    )
+    
+    if result.returncode == 0:
+        click.echo(result.stdout)
+    else:
+        ctx.obj['console'].print(f"[red]Error generating completion: {result.stderr}[/red]")
+        sys.exit(1)
+
+
+@main.group()
+def history() -> None:
+    """Manage conversation history."""
+    pass
+
+
+@history.command('list')
+@click.option('-n', '--limit', type=int, default=10, help='Number of conversations to show')
+@click.option('-s', '--search', help='Search conversations')
+@click.pass_context
+def history_list(ctx: click.Context, limit: int, search: Optional[str]) -> None:
+    """List conversation history."""
+    console = ctx.obj['console']
+    config = Config()
+    conv_history = ConversationHistory(config.config_dir / "history")
+    
+    conversations = conv_history.list_conversations(limit=limit, search_query=search)
+    
+    if not conversations:
+        console.print("[yellow]No conversations found[/yellow]")
+        return
+    
+    for conv in conversations:
+        summary = conv.get_summary(80)
+        console.print(f"\n[cyan]{conv.conversation_id}[/cyan]")
+        console.print(f"[dim]{conv.updated_at.strftime('%Y-%m-%d %H:%M')} | {len(conv.messages)} messages[/dim]")
+        console.print(f"  {summary}")
+
+
+@history.command('export')
+@click.argument('conversation_id')
+@click.option('--format', type=click.Choice(['markdown', 'json']), default='markdown')
+@click.option('-o', '--output', type=click.Path(), help='Output file')
+@click.pass_context
+def history_export(ctx: click.Context, conversation_id: str, format: str, output: Optional[str]) -> None:
+    """Export a conversation."""
+    console = ctx.obj['console']
+    config = Config()
+    conv_history = ConversationHistory(config.config_dir / "history")
+    
+    content = conv_history.export_conversation(conversation_id, format)
+    if not content:
+        console.print(f"[red]Conversation {conversation_id} not found[/red]")
         sys.exit(1)
+    
+    if output:
+        Path(output).write_text(content)
+        console.print(f"[green]✓[/green] Exported to {output}")
+    else:
+        click.echo(content)
 
 
 @main.group()
@@ -577,5 +754,208 @@ def toon_info(ctx: click.Context) -> None:
         console.print("• Same data, fewer tokens")
 
 
+@main.group()
+def template() -> None:
+    """Manage custom prompt templates."""
+    pass
+
+
+@template.command('list')
+@click.option('-c', '--category', help='Filter by category')
+@click.option('--builtin', is_flag=True, help='Show only built-in templates')
+@click.option('--user', is_flag=True, help='Show only user templates')
+@click.pass_context
+def template_list(
+    ctx: click.Context,
+    category: Optional[str],
+    builtin: bool,
+    user: bool
+) -> None:
+    """List available templates."""
+    console = ctx.obj['console']
+    config = Config()
+    manager = TemplateManager(config.config_dir)
+    
+    templates = manager.list_templates(
+        category=category,
+        builtin_only=builtin,
+        user_only=user
+    )
+    
+    if not templates:
+        console.print("[yellow]No templates found.[/yellow]")
+        return
+    
+    from rich.table import Table
+    
+    table = Table(show_header=True, header_style="bold magenta")
+    table.add_column("Name", style="cyan")
+    table.add_column("Category", style="green")
+    table.add_column("Variables", style="yellow")
+    table.add_column("Type", style="blue")
+    table.add_column("Description")
+    
+    for tmpl in templates:
+        vars_display = ", ".join(tmpl.variables) if tmpl.variables else "-"
+        type_display = "🔒 Built-in" if tmpl.builtin else "📝 User"
+        table.add_row(
+            tmpl.name,
+            tmpl.category,
+            vars_display,
+            type_display,
+            tmpl.description
+        )
+    
+    console.print(table)
+    
+    # Show categories
+    categories = manager.get_categories()
+    console.print(f"\n[dim]Categories: {', '.join(categories)}[/dim]")
+
+
+@template.command('show')
+@click.argument('name')
+@click.pass_context
+def template_show(ctx: click.Context, name: str) -> None:
+    """Show template details."""
+    console = ctx.obj['console']
+    config = Config()
+    manager = TemplateManager(config.config_dir)
+    
+    tmpl = manager.get_template(name)
+    if not tmpl:
+        console.print(f"[red]Template not found: {name}[/red]")
+        sys.exit(1)
+    
+    console.print(Panel(
+        f"[bold]{tmpl.name}[/bold]\n\n"
+        f"[dim]{tmpl.description}[/dim]\n\n"
+        f"Category: [green]{tmpl.category}[/green]\n"
+        f"Type: {'🔒 Built-in' if tmpl.builtin else '📝 User'}\n"
+        f"Variables: [yellow]{', '.join(tmpl.variables) if tmpl.variables else 'None'}[/yellow]",
+        title="Template Info",
+        border_style="blue"
+    ))
+    
+    console.print("\n[bold]Content:[/bold]\n")
+    console.print(Panel(tmpl.content, border_style="dim"))
+
+
+@template.command('add')
+@click.argument('name')
+@click.option('-c', '--content', help='Template content (or use stdin)')
+@click.option('-d', '--description', help='Template description')
+@click.option('--category', default='general', help='Template category')
+@click.pass_context
+def template_add(
+    ctx: click.Context,
+    name: str,
+    content: Optional[str],
+    description: Optional[str],
+    category: str
+) -> None:
+    """Add a new template."""
+    console = ctx.obj['console']
+    config = Config()
+    manager = TemplateManager(config.config_dir)
+    
+    # Get content from stdin if not provided
+    if not content:
+        if sys.stdin.isatty():
+            console.print("[yellow]Enter template content (Ctrl+D to finish):[/yellow]")
+        content = sys.stdin.read().strip()
+    
+    if not content:
+        console.print("[red]Error: No content provided[/red]")
+        sys.exit(1)
+    
+    try:
+        tmpl = Template(
+            name=name,
+            content=content,
+            description=description,
+            category=category
+        )
+        manager.add_template(tmpl)
+        
+        console.print(f"[green]✓[/green] Template added: {name}")
+        if tmpl.variables:
+            console.print(f"[dim]Variables: {', '.join(tmpl.variables)}[/dim]")
+    
+    except ValueError as e:
+        console.print(f"[red]Error: {e}[/red]")
+        sys.exit(1)
+
+
+@template.command('delete')
+@click.argument('name')
+@click.pass_context
+def template_delete(ctx: click.Context, name: str) -> None:
+    """Delete a user template."""
+    console = ctx.obj['console']
+    config = Config()
+    manager = TemplateManager(config.config_dir)
+    
+    try:
+        if manager.delete_template(name):
+            console.print(f"[green]✓[/green] Template deleted: {name}")
+        else:
+            console.print(f"[red]Template not found: {name}[/red]")
+            sys.exit(1)
+    
+    except ValueError as e:
+        console.print(f"[red]Error: {e}[/red]")
+        sys.exit(1)
+
+
+@template.command('use')
+@click.argument('name')
+@click.option('-a', '--api', help='API config to use')
+@click.option('-m', '--model', help='Claude model to use')
+@click.pass_context
+def template_use(ctx: click.Context, name: str, api: Optional[str], model: Optional[str]) -> None:
+    """Use a template with interactive variable input."""
+    console = ctx.obj['console']
+    config = Config()
+    manager = TemplateManager(config.config_dir)
+    
+    tmpl = manager.get_template(name)
+    if not tmpl:
+        console.print(f"[red]Template not found: {name}[/red]")
+        sys.exit(1)
+    
+    # Get variable values
+    variables = {}
+    if tmpl.variables:
+        console.print(f"\n[bold]Template: {name}[/bold]")
+        console.print(f"[dim]{tmpl.description}[/dim]\n")
+        
+        for var in tmpl.variables:
+            value = console.input(f"[cyan]{var}:[/cyan] ").strip()
+            variables[var] = value
+    
+    # Check for missing variables
+    missing = tmpl.get_missing_variables(**variables)
+    if missing:
+        console.print(f"[red]Missing required variables: {', '.join(missing)}[/red]")
+        sys.exit(1)
+    
+    # Render template
+    prompt = tmpl.render(**variables)
+    
+    # Call Claude
+    try:
+        client = ClaudeClient(api_config_name=api)
+        
+        console.print("\n[bold green]Claude:[/bold green] ", end='')
+        for chunk in client.call_streaming(prompt, model=model):
+            console.print(chunk, end='')
+        console.print()
+    
+    except Exception as e:
+        console.print(f"\n[red]Error: {e}[/red]")
+        sys.exit(1)
+
+
 if __name__ == '__main__':
     main(obj={})

claude_dev_cli/history.py

@@ -0,0 +1,189 @@
+"""Conversation history management for interactive mode."""
+
+import json
+from datetime import datetime
+from pathlib import Path
+from typing import List, Optional, Dict, Any
+
+
+class Message:
+    """Represents a single message in a conversation."""
+    
+    def __init__(self, role: str, content: str, timestamp: Optional[datetime] = None):
+        self.role = role  # "user" or "assistant"
+        self.content = content
+        self.timestamp = timestamp or datetime.utcnow()
+    
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to dictionary for storage."""
+        return {
+            "role": self.role,
+            "content": self.content,
+            "timestamp": self.timestamp.isoformat()
+        }
+    
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "Message":
+        """Create from dictionary."""
+        return cls(
+            role=data["role"],
+            content=data["content"],
+            timestamp=datetime.fromisoformat(data["timestamp"])
+        )
+
+
+class Conversation:
+    """Represents a conversation with messages."""
+    
+    def __init__(
+        self,
+        conversation_id: Optional[str] = None,
+        created_at: Optional[datetime] = None,
+        updated_at: Optional[datetime] = None
+    ):
+        self.conversation_id = conversation_id or datetime.utcnow().strftime("%Y%m%d_%H%M%S")
+        self.created_at = created_at or datetime.utcnow()
+        self.updated_at = updated_at or datetime.utcnow()
+        self.messages: List[Message] = []
+    
+    def add_message(self, role: str, content: str) -> None:
+        """Add a message to the conversation."""
+        message = Message(role, content)
+        self.messages.append(message)
+        self.updated_at = datetime.utcnow()
+    
+    def get_summary(self, max_length: int = 100) -> str:
+        """Get a summary of the conversation (first user message)."""
+        for msg in self.messages:
+            if msg.role == "user":
+                summary = msg.content[:max_length]
+                if len(msg.content) > max_length:
+                    summary += "..."
+                return summary
+        return "(empty conversation)"
+    
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to dictionary for storage."""
+        return {
+            "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]
+        }
+    
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "Conversation":
+        """Create from dictionary."""
+        conv = cls(
+            conversation_id=data["conversation_id"],
+            created_at=datetime.fromisoformat(data["created_at"]),
+            updated_at=datetime.fromisoformat(data["updated_at"])
+        )
+        conv.messages = [Message.from_dict(msg) for msg in data.get("messages", [])]
+        return conv
+
+
+class ConversationHistory:
+    """Manages conversation history storage and retrieval."""
+    
+    def __init__(self, history_dir: Path):
+        self.history_dir = history_dir
+        self.history_dir.mkdir(parents=True, exist_ok=True)
+    
+    def _get_conversation_file(self, conversation_id: str) -> Path:
+        """Get the file path for a conversation."""
+        return self.history_dir / f"{conversation_id}.json"
+    
+    def save_conversation(self, conversation: Conversation) -> None:
+        """Save a conversation to disk."""
+        file_path = self._get_conversation_file(conversation.conversation_id)
+        with open(file_path, 'w') as f:
+            json.dump(conversation.to_dict(), f, indent=2)
+    
+    def load_conversation(self, conversation_id: str) -> Optional[Conversation]:
+        """Load a conversation from disk."""
+        file_path = self._get_conversation_file(conversation_id)
+        if not file_path.exists():
+            return None
+        
+        try:
+            with open(file_path, 'r') as f:
+                data = json.load(f)
+            return Conversation.from_dict(data)
+        except Exception:
+            return None
+    
+    def list_conversations(
+        self,
+        limit: Optional[int] = None,
+        search_query: Optional[str] = None
+    ) -> List[Conversation]:
+        """List all conversations, optionally filtered and limited."""
+        conversations = []
+        
+        for file_path in sorted(self.history_dir.glob("*.json"), reverse=True):
+            try:
+                with open(file_path, 'r') as f:
+                    data = json.load(f)
+                conv = Conversation.from_dict(data)
+                
+                # Apply search filter if provided
+                if search_query:
+                    search_lower = search_query.lower()
+                    found = False
+                    for msg in conv.messages:
+                        if search_lower in msg.content.lower():
+                            found = True
+                            break
+                    if not found:
+                        continue
+                
+                conversations.append(conv)
+                
+                if limit and len(conversations) >= limit:
+                    break
+            except Exception:
+                continue
+        
+        return conversations
+    
+    def delete_conversation(self, conversation_id: str) -> bool:
+        """Delete a conversation."""
+        file_path = self._get_conversation_file(conversation_id)
+        if file_path.exists():
+            file_path.unlink()
+            return True
+        return False
+    
+    def get_latest_conversation(self) -> Optional[Conversation]:
+        """Get the most recent conversation."""
+        conversations = self.list_conversations(limit=1)
+        return conversations[0] if conversations else None
+    
+    def export_conversation(
+        self,
+        conversation_id: str,
+        output_format: str = "markdown"
+    ) -> Optional[str]:
+        """Export a conversation to a specific format."""
+        conv = self.load_conversation(conversation_id)
+        if not conv:
+            return None
+        
+        if output_format == "markdown":
+            lines = [f"# Conversation: {conv.conversation_id}"]
+            lines.append(f"\nCreated: {conv.created_at.strftime('%Y-%m-%d %H:%M:%S')}")
+            lines.append(f"Updated: {conv.updated_at.strftime('%Y-%m-%d %H:%M:%S')}\n")
+            
+            for msg in conv.messages:
+                role_display = "**You:**" if msg.role == "user" else "**Claude:**"
+                lines.append(f"\n## {role_display}\n")
+                lines.append(msg.content)
+                lines.append("")
+            
+            return "\n".join(lines)
+        
+        elif output_format == "json":
+            return json.dumps(conv.to_dict(), indent=2)
+        
+        return None

claude_dev_cli/template_manager.py

@@ -0,0 +1,288 @@
+"""Template management for reusable prompts."""
+
+import json
+import re
+from pathlib import Path
+from typing import Dict, List, Optional, Any
+
+
+class Template:
+    """Represents a reusable prompt template."""
+    
+    def __init__(
+        self,
+        name: str,
+        content: str,
+        description: Optional[str] = None,
+        variables: Optional[List[str]] = None,
+        category: Optional[str] = None,
+        builtin: bool = False
+    ):
+        self.name = name
+        self.content = content
+        self.description = description or ""
+        self.variables = variables or self._extract_variables(content)
+        self.category = category or "general"
+        self.builtin = builtin
+    
+    @staticmethod
+    def _extract_variables(content: str) -> List[str]:
+        """Extract {{variable}} placeholders from content."""
+        return list(set(re.findall(r'\{\{(\w+)\}\}', content)))
+    
+    def render(self, **kwargs: str) -> str:
+        """Render template with provided variables."""
+        result = self.content
+        for var, value in kwargs.items():
+            result = result.replace(f'{{{{{var}}}}}', value)
+        return result
+    
+    def get_missing_variables(self, **kwargs: str) -> List[str]:
+        """Get list of required variables not provided."""
+        return [var for var in self.variables if var not in kwargs]
+    
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to dictionary for storage."""
+        return {
+            "name": self.name,
+            "content": self.content,
+            "description": self.description,
+            "variables": self.variables,
+            "category": self.category,
+            "builtin": self.builtin
+        }
+    
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "Template":
+        """Create from dictionary."""
+        return cls(
+            name=data["name"],
+            content=data["content"],
+            description=data.get("description", ""),
+            variables=data.get("variables", []),
+            category=data.get("category", "general"),
+            builtin=data.get("builtin", False)
+        )
+
+
+class TemplateManager:
+    """Manages template storage and retrieval."""
+    
+    # Built-in templates
+    BUILTIN_TEMPLATES = [
+        Template(
+            name="code-review",
+            content="""Review this code for:
+- Security vulnerabilities
+- Performance issues  
+- Best practices
+- Potential bugs
+- Code clarity
+
+{{code}}
+
+Focus on: {{focus}}""",
+            description="Comprehensive code review with customizable focus",
+            category="review",
+            builtin=True
+        ),
+        Template(
+            name="code-review-security",
+            content="""Perform a security-focused code review of this code:
+
+{{code}}
+
+Check for:
+- SQL injection vulnerabilities
+- XSS vulnerabilities
+- Authentication/authorization issues
+- Data validation problems
+- Sensitive data exposure
+- CSRF vulnerabilities""",
+            description="Security-focused code review",
+            category="review",
+            builtin=True
+        ),
+        Template(
+            name="test-strategy",
+            content="""Generate a comprehensive test strategy for this {{language}} code:
+
+{{code}}
+
+Include:
+- Unit tests for core functionality
+- Edge cases and error handling
+- Integration test scenarios
+- Mock/stub suggestions
+- Test data examples""",
+            description="Generate testing strategy and test cases",
+            category="testing",
+            builtin=True
+        ),
+        Template(
+            name="debug-error",
+            content="""Help me debug this error:
+
+Error: {{error}}
+
+Code context:
+{{code}}
+
+Please:
+1. Explain what's causing the error
+2. Suggest fixes with code examples
+3. Explain how to prevent similar errors""",
+            description="Debug error with context",
+            category="debugging",
+            builtin=True
+        ),
+        Template(
+            name="optimize-performance",
+            content="""Analyze this code for performance optimization:
+
+{{code}}
+
+Consider:
+- Time complexity improvements
+- Memory usage optimization
+- Algorithm efficiency
+- Database query optimization (if applicable)
+- Caching opportunities
+
+Provide specific code improvements.""",
+            description="Performance optimization analysis",
+            category="optimization",
+            builtin=True
+        ),
+        Template(
+            name="refactor-clean",
+            content="""Refactor this code to improve:
+- Readability
+- Maintainability
+- Code organization
+- Naming conventions
+- {{language}} idioms
+
+{{code}}
+
+Provide the refactored version with explanations.""",
+            description="Clean code refactoring",
+            category="refactoring",
+            builtin=True
+        ),
+        Template(
+            name="explain-code",
+            content="""Explain this code in detail:
+
+{{code}}
+
+Include:
+- What it does (high-level)
+- How it works (step-by-step)
+- Why certain approaches were used
+- Potential improvements
+
+Audience level: {{level}}""",
+            description="Detailed code explanation",
+            category="documentation",
+            builtin=True
+        ),
+        Template(
+            name="api-design",
+            content="""Design a {{style}} API for:
+
+{{description}}
+
+Include:
+- Endpoint definitions
+- Request/response formats
+- Error handling
+- Authentication approach
+- Rate limiting considerations""",
+            description="API design assistance",
+            category="design",
+            builtin=True
+        ),
+    ]
+    
+    def __init__(self, templates_dir: Path):
+        self.templates_dir = templates_dir
+        self.templates_file = templates_dir / "templates.json"
+        self.templates_dir.mkdir(parents=True, exist_ok=True)
+        self._load_templates()
+    
+    def _load_templates(self) -> None:
+        """Load templates from disk."""
+        self.templates: Dict[str, Template] = {}
+        
+        # Load built-in templates
+        for template in self.BUILTIN_TEMPLATES:
+            self.templates[template.name] = template
+        
+        # Load user templates
+        if self.templates_file.exists():
+            try:
+                with open(self.templates_file, 'r') as f:
+                    data = json.load(f)
+                for template_data in data.get("templates", []):
+                    template = Template.from_dict(template_data)
+                    self.templates[template.name] = template
+            except Exception:
+                pass
+    
+    def _save_templates(self) -> None:
+        """Save user templates to disk."""
+        # Only save non-builtin templates
+        user_templates = [
+            t.to_dict() for t in self.templates.values() if not t.builtin
+        ]
+        
+        with open(self.templates_file, 'w') as f:
+            json.dump({"templates": user_templates}, f, indent=2)
+    
+    def add_template(self, template: Template) -> None:
+        """Add or update a template."""
+        if template.name in self.templates and self.templates[template.name].builtin:
+            raise ValueError(f"Cannot override builtin template: {template.name}")
+        
+        self.templates[template.name] = template
+        self._save_templates()
+    
+    def get_template(self, name: str) -> Optional[Template]:
+        """Get a template by name."""
+        return self.templates.get(name)
+    
+    def list_templates(
+        self,
+        category: Optional[str] = None,
+        builtin_only: bool = False,
+        user_only: bool = False
+    ) -> List[Template]:
+        """List templates with optional filters."""
+        templates = list(self.templates.values())
+        
+        if category:
+            templates = [t for t in templates if t.category == category]
+        
+        if builtin_only:
+            templates = [t for t in templates if t.builtin]
+        elif user_only:
+            templates = [t for t in templates if not t.builtin]
+        
+        return sorted(templates, key=lambda t: (t.category, t.name))
+    
+    def delete_template(self, name: str) -> bool:
+        """Delete a template (cannot delete builtins)."""
+        if name not in self.templates:
+            return False
+        
+        if self.templates[name].builtin:
+            raise ValueError(f"Cannot delete builtin template: {name}")
+        
+        del self.templates[name]
+        self._save_templates()
+        return True
+    
+    def get_categories(self) -> List[str]:
+        """Get list of all template categories."""
+        return sorted(set(t.category for t in self.templates.values()))

{claude_dev_cli-0.4.0.dist-info → claude_dev_cli-0.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-dev-cli
-Version: 0.4.0
+Version: 0.6.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
@@ -72,6 +72,12 @@ A powerful command-line tool for developers using Claude AI with multi-API routi
 - **Interactive**: Chat mode with conversation history
 - **Streaming**: Real-time responses
 
+### 📝 Custom Templates
+- **Built-in Templates**: 8 pre-built templates for common tasks (code review, testing, debugging, etc.)
+- **User Templates**: Create and manage your own reusable prompt templates
+- **Variable Substitution**: Use {{variable}} placeholders for dynamic content
+- **Categories**: Organize templates by category (review, testing, debugging, etc.)
+
 ### 🎒 TOON Format Support (Optional)
 - **Token Reduction**: 30-60% fewer tokens than JSON
 - **Cost Savings**: Reduce API costs significantly
@@ -156,7 +162,44 @@ git add .
 cdc git commit
 ```
 
-### 4. Usage Tracking
+### 5. Custom Templates
+
+```bash
+# List all templates (built-in and user)
+cdc template list
+
+# Show template details
+cdc template show code-review
+
+# Add a custom template
+cdc template add my-review -c "Review this code for {{focus}}: {{code}}" \
+  -d "Custom review template" --category review
+
+# Use a template (interactive variable input)
+cdc template use debug-error
+
+# Delete a user template
+cdc template delete my-review
+
+# Filter by category
+cdc template list --category review
+
+# Show only user templates
+cdc template list --user
+```
+
+#### Built-in Templates
+
+- **code-review**: Comprehensive code review with customizable focus
+- **code-review-security**: Security-focused code review
+- **test-strategy**: Generate testing strategy and test cases
+- **debug-error**: Debug error with context
+- **optimize-performance**: Performance optimization analysis
+- **refactor-clean**: Clean code refactoring
+- **explain-code**: Detailed code explanation
+- **api-design**: API design assistance
+
+### 6. Usage Tracking
 
 ```bash
 # View all usage
@@ -169,7 +212,7 @@ cdc usage --days 7
 cdc usage --api client
 ```
 
-### 5. TOON Format (Optional - Reduces Tokens by 30-60%)
+### 7. TOON Format (Optional - Reduces Tokens by 30-60%)
 
 ```bash
 # Check if TOON is installed
@@ -322,6 +365,16 @@ When using a client's Enterprise API:
 | `cdc debug -f <file> -e <error>` | Debug code |
 | `cdc refactor <file>` | Refactoring suggestions |
 
+### Templates
+
+| Command | Description |
+|---------|-------------|
+| `cdc template list` | List all templates |
+| `cdc template show <name>` | Show template details |
+| `cdc template add <name>` | Add new template |
+| `cdc template delete <name>` | Delete user template |
+| `cdc template use <name>` | Use template interactively |
+
 ### Git Helpers
 
 | Command | Description |

{claude_dev_cli-0.4.0.dist-info → claude_dev_cli-0.6.0.dist-info}/RECORD

@@ -1,9 +1,11 @@
-claude_dev_cli/__init__.py,sha256=2ulyIQ3E-s6wBTKyeXAlqHMVA73zUGdaaNUsFiJ-nqs,469
-claude_dev_cli/cli.py,sha256=KeBRudNvKU7RzO_m1w50WyiKwAMEp3U9LNal0R_FEGk,18194
+claude_dev_cli/__init__.py,sha256=8WXldNvP94ff1oD0MSxSxb5h0bEF-eJZyVHPopW8gq8,469
+claude_dev_cli/cli.py,sha256=KJbUDQl_hA7jgLGxXQs01MW6inzevQk6d7_mUvvAAB8,31296
 claude_dev_cli/commands.py,sha256=RKGx2rv56PM6eErvA2uoQ20hY8babuI5jav8nCUyUOk,3964
 claude_dev_cli/config.py,sha256=RGX0sKplHUsrJJmU-4FuWWjoTbQVgWaMT8DgRUofrR4,8134
 claude_dev_cli/core.py,sha256=yaLjEixDvPzvUy4fJ2UB7nMpPPLyKACjR-RuM-1OQBY,4780
+claude_dev_cli/history.py,sha256=iQlqgTnXCsyCq5q-XaDl7V5MyPKQ3bx7o_k76-xWSAA,6863
 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
 claude_dev_cli/toon_utils.py,sha256=S3px2UvmNEaltmTa5K-h21n2c0CPvYjZc9mc7kHGqNQ,2828
 claude_dev_cli/usage.py,sha256=32rs0_dUn6ihha3vCfT3rwnvel_-sED7jvLpO7gu-KQ,7446
@@ -12,9 +14,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.4.0.dist-info/licenses/LICENSE,sha256=DGueuJwMJtMwgLO5mWlS0TaeBrFwQuNpNZ22PU9J2bw,1062
-claude_dev_cli-0.4.0.dist-info/METADATA,sha256=tfugybDPK3KyZTBcm8PHlEeb_ZidSWtRaKAwIBfIn70,11288
-claude_dev_cli-0.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-claude_dev_cli-0.4.0.dist-info/entry_points.txt,sha256=zymgUIIVpFTARkFmxAuW2A4BQsNITh_L0uU-XunytHg,85
-claude_dev_cli-0.4.0.dist-info/top_level.txt,sha256=m7MF6LOIuTe41IT5Fgt0lc-DK1EgM4gUU_IZwWxK0pg,15
-claude_dev_cli-0.4.0.dist-info/RECORD,,
+claude_dev_cli-0.6.0.dist-info/licenses/LICENSE,sha256=DGueuJwMJtMwgLO5mWlS0TaeBrFwQuNpNZ22PU9J2bw,1062
+claude_dev_cli-0.6.0.dist-info/METADATA,sha256=d1aptyTDwcmtYPMrSgTk4j5pHCPgVriDnyjx--JjDCk,12984
+claude_dev_cli-0.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+claude_dev_cli-0.6.0.dist-info/entry_points.txt,sha256=zymgUIIVpFTARkFmxAuW2A4BQsNITh_L0uU-XunytHg,85
+claude_dev_cli-0.6.0.dist-info/top_level.txt,sha256=m7MF6LOIuTe41IT5Fgt0lc-DK1EgM4gUU_IZwWxK0pg,15
+claude_dev_cli-0.6.0.dist-info/RECORD,,