tunacode-cli 0.0.5__tar.gz → 0.0.6__tar.gz

tunacode_cli-0.0.6/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.4
+Name: tunacode-cli
+Version: 0.0.6
+Summary: Your agentic CLI developer.
+Author-email: larock22 <noreply@github.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/larock22/tunacode
+Project-URL: Repository, https://github.com/larock22/tunacode
+Keywords: cli,agent,development,automation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: prompt_toolkit==3.0.51
+Requires-Dist: tiny_agent_os>=0.1.0
+Requires-Dist: pygments==2.19.1
+Requires-Dist: rich==14.0.0
+Requires-Dist: typer==0.15.3
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Dynamic: license-file
+
+# 🐟 TunaCode
+
+[![PyPI version](https://badge.fury.io/py/tunacode-cli.svg)](https://badge.fury.io/py/tunacode-cli)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+![Chuna](chuna.jpg_medium)
+
+**Your agentic CLI developer** - An open-source alternative to Claude Code, Copilot, and Cursor with multi-provider LLM support.
+
+
+## ✨ What's New (v0.1.0)
+
+- 🚀 **60% faster startup** with lazy loading and optimizations
+- 🤖 **TinyAgent integration** for robust ReAct-based interactions
+- 🛡️ **Three-layer undo system** with automatic failover
+- 📊 **Enhanced model selection** with fuzzy matching and cost indicators
+- 📁 **Project-local backups** in `.tunacode/` directory
+
+## 🎯 Features
+
+### Core Capabilities
+- **🔓 No vendor lock-in** - Use any LLM provider (OpenAI, Anthropic, Google, 100+ via OpenRouter)
+- **⚡ Fast & responsive** - Optimized for speed with <5ms operation overhead
+- **🛡️ Safe operations** - Three-layer undo system ensures nothing is lost
+- **🎨 Modern CLI** - Beautiful terminal UI with syntax highlighting
+- **💰 Cost tracking** - Monitor tokens and costs per session
+
+### Developer Experience
+- **🔄 Hot model switching** - Change models mid-conversation with `/model`
+- **📝 Project guides** - Customize behavior with `TUNACODE.md` files
+- **🚀 YOLO mode** - Skip confirmations when you're confident
+- **🔧 MCP support** - Extend with Model Context Protocol servers
+- **📊 Git integration** - Automatic branch creation and undo support
+
+## 🚀 Quick Start
+
+```bash
+# Install from PyPI
+pip install tunacode-cli
+
+# Run setup (first time only)
+tunacode
+
+# Start coding!
+tunacode
+> Help me refactor this codebase to use async/await
+```
+
+## 📋 Commands
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `/model` or `/m` | List and switch models | `/model 3` or `/m opus` |
+| `/yolo` | Toggle confirmation skipping | `/yolo` |
+| `/undo` | Undo last file operation | `/undo` |
+| `/clear` | Clear conversation history | `/clear` |
+| `/branch <name>` | Create new git branch | `/branch feature/auth` |
+| `/compact` | Summarize and trim history | `/compact` |
+| `/help` | Show all commands | `/help` |
+
+## 🔧 Configuration
+
+Configuration is stored in `~/.config/tunacode.json`:
+
+```json
+{
+  "default_model": "openai:gpt-4o",
+  "env": {
+    "OPENAI_API_KEY": "sk-...",
+    "ANTHROPIC_API_KEY": "sk-ant-...",
+    "OPENROUTER_API_KEY": "sk-or-..."
+  },
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "..."}
+    }
+  }
+}
+```
+
+### Using OpenRouter (100+ Models)
+
+```bash
+# Add your OpenRouter API key to config
+# Then run with OpenRouter base URL:
+OPENAI_BASE_URL="https://openrouter.ai/api/v1" tunacode
+
+# Use any OpenRouter model:
+/model openrouter:anthropic/claude-3-opus
+/model openrouter:mistralai/devstral-small
+/model openrouter:openai/gpt-4.1
+```
+
+## 🛡️ Undo System
+
+TunaCode provides **three layers of protection** for your files:
+
+1. **Git commits** - Primary undo mechanism (if available)
+2. **Operation log** - Tracks changes with content (<100KB files)
+3. **File backups** - Physical copies in `.tunacode/backups/`
+
+All undo data is stored locally in your project:
+
+```
+your-project/
+└── .tunacode/          # Auto-created, gitignored
+    ├── backups/        # Timestamped file copies
+    ├── operations.jsonl # Change history
+    └── README.md       # Explains the directory
+```
+
+## 🎯 Project Customization
+
+Create a `TUNACODE.md` file in your project root:
+
+```markdown
+# Project Guidelines for TunaCode
+
+## Tech Stack
+- Next.js 14 with App Router
+- TypeScript with strict mode
+- Tailwind CSS for styling
+
+## Conventions
+- Use arrow functions for components
+- Prefer server components where possible
+- Follow conventional commits
+
+## Commands
+- `npm run dev` - Start development
+- `npm test` - Run tests
+```
+
+## ⚡ Performance
+
+TunaCode is optimized for speed:
+- **Startup time**: ~0.5-0.8 seconds
+- **Model switching**: ~100ms  
+- **File operations**: ~5ms overhead
+- **API calls**: Connection pooling enabled
+
+## 🔧 Advanced Usage
+
+### Environment Variables
+```bash
+# Use different base URLs
+OPENAI_BASE_URL="https://openrouter.ai/api/v1" tunacode
+
+# Disable undo system
+TUNACODE_NO_UNDO=1 tunacode
+
+# Set default model
+TUNACODE_MODEL="anthropic:claude-3-opus" tunacode
+```
+
+### MCP Servers
+Extend TunaCode with Model Context Protocol servers for web fetching, database access, and more. See [modelcontextprotocol.io](https://modelcontextprotocol.io/) for available servers.
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+```bash
+# Setup development environment
+git clone https://github.com/larock22/tunacode
+cd tunacode
+pip install -e ".[dev]"
+
+# Run tests
+make test
+
+# Lint code
+make lint
+```
+
+## 📚 Documentation
+
+- [Architecture Overview](docs/architecture.md)
+- [API Integration](API_CALL_FLOW.md)
+- [Undo System Design](UNDO_SYSTEM_DESIGN.md)
+- [Performance Guide](PERFORMANCE_OPTIMIZATIONS.md)
+
+## 🙏 Acknowledgments
+
+TunaCode is built on the foundation of [sidekick-cli](https://github.com/geekforbrains/sidekick-cli). Special thanks to:
+- The sidekick-cli team for the original codebase
+- [TinyAgent](https://github.com/alchemiststudiosDOTai/tinyAgent) for the robust agent framework
+- The open-source community for feedback and contributions
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+**Note**: TunaCode is in active development. Please [report issues](https://github.com/larock22/tunacode/issues) or share feedback!

tunacode_cli-0.0.6/README.md

@@ -0,0 +1,199 @@
+# 🐟 TunaCode
+
+[![PyPI version](https://badge.fury.io/py/tunacode-cli.svg)](https://badge.fury.io/py/tunacode-cli)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+![Chuna](chuna.jpg_medium)
+
+**Your agentic CLI developer** - An open-source alternative to Claude Code, Copilot, and Cursor with multi-provider LLM support.
+
+
+## ✨ What's New (v0.1.0)
+
+- 🚀 **60% faster startup** with lazy loading and optimizations
+- 🤖 **TinyAgent integration** for robust ReAct-based interactions
+- 🛡️ **Three-layer undo system** with automatic failover
+- 📊 **Enhanced model selection** with fuzzy matching and cost indicators
+- 📁 **Project-local backups** in `.tunacode/` directory
+
+## 🎯 Features
+
+### Core Capabilities
+- **🔓 No vendor lock-in** - Use any LLM provider (OpenAI, Anthropic, Google, 100+ via OpenRouter)
+- **⚡ Fast & responsive** - Optimized for speed with <5ms operation overhead
+- **🛡️ Safe operations** - Three-layer undo system ensures nothing is lost
+- **🎨 Modern CLI** - Beautiful terminal UI with syntax highlighting
+- **💰 Cost tracking** - Monitor tokens and costs per session
+
+### Developer Experience
+- **🔄 Hot model switching** - Change models mid-conversation with `/model`
+- **📝 Project guides** - Customize behavior with `TUNACODE.md` files
+- **🚀 YOLO mode** - Skip confirmations when you're confident
+- **🔧 MCP support** - Extend with Model Context Protocol servers
+- **📊 Git integration** - Automatic branch creation and undo support
+
+## 🚀 Quick Start
+
+```bash
+# Install from PyPI
+pip install tunacode-cli
+
+# Run setup (first time only)
+tunacode
+
+# Start coding!
+tunacode
+> Help me refactor this codebase to use async/await
+```
+
+## 📋 Commands
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `/model` or `/m` | List and switch models | `/model 3` or `/m opus` |
+| `/yolo` | Toggle confirmation skipping | `/yolo` |
+| `/undo` | Undo last file operation | `/undo` |
+| `/clear` | Clear conversation history | `/clear` |
+| `/branch <name>` | Create new git branch | `/branch feature/auth` |
+| `/compact` | Summarize and trim history | `/compact` |
+| `/help` | Show all commands | `/help` |
+
+## 🔧 Configuration
+
+Configuration is stored in `~/.config/tunacode.json`:
+
+```json
+{
+  "default_model": "openai:gpt-4o",
+  "env": {
+    "OPENAI_API_KEY": "sk-...",
+    "ANTHROPIC_API_KEY": "sk-ant-...",
+    "OPENROUTER_API_KEY": "sk-or-..."
+  },
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "..."}
+    }
+  }
+}
+```
+
+### Using OpenRouter (100+ Models)
+
+```bash
+# Add your OpenRouter API key to config
+# Then run with OpenRouter base URL:
+OPENAI_BASE_URL="https://openrouter.ai/api/v1" tunacode
+
+# Use any OpenRouter model:
+/model openrouter:anthropic/claude-3-opus
+/model openrouter:mistralai/devstral-small
+/model openrouter:openai/gpt-4.1
+```
+
+## 🛡️ Undo System
+
+TunaCode provides **three layers of protection** for your files:
+
+1. **Git commits** - Primary undo mechanism (if available)
+2. **Operation log** - Tracks changes with content (<100KB files)
+3. **File backups** - Physical copies in `.tunacode/backups/`
+
+All undo data is stored locally in your project:
+
+```
+your-project/
+└── .tunacode/          # Auto-created, gitignored
+    ├── backups/        # Timestamped file copies
+    ├── operations.jsonl # Change history
+    └── README.md       # Explains the directory
+```
+
+## 🎯 Project Customization
+
+Create a `TUNACODE.md` file in your project root:
+
+```markdown
+# Project Guidelines for TunaCode
+
+## Tech Stack
+- Next.js 14 with App Router
+- TypeScript with strict mode
+- Tailwind CSS for styling
+
+## Conventions
+- Use arrow functions for components
+- Prefer server components where possible
+- Follow conventional commits
+
+## Commands
+- `npm run dev` - Start development
+- `npm test` - Run tests
+```
+
+## ⚡ Performance
+
+TunaCode is optimized for speed:
+- **Startup time**: ~0.5-0.8 seconds
+- **Model switching**: ~100ms  
+- **File operations**: ~5ms overhead
+- **API calls**: Connection pooling enabled
+
+## 🔧 Advanced Usage
+
+### Environment Variables
+```bash
+# Use different base URLs
+OPENAI_BASE_URL="https://openrouter.ai/api/v1" tunacode
+
+# Disable undo system
+TUNACODE_NO_UNDO=1 tunacode
+
+# Set default model
+TUNACODE_MODEL="anthropic:claude-3-opus" tunacode
+```
+
+### MCP Servers
+Extend TunaCode with Model Context Protocol servers for web fetching, database access, and more. See [modelcontextprotocol.io](https://modelcontextprotocol.io/) for available servers.
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+```bash
+# Setup development environment
+git clone https://github.com/larock22/tunacode
+cd tunacode
+pip install -e ".[dev]"
+
+# Run tests
+make test
+
+# Lint code
+make lint
+```
+
+## 📚 Documentation
+
+- [Architecture Overview](docs/architecture.md)
+- [API Integration](API_CALL_FLOW.md)
+- [Undo System Design](UNDO_SYSTEM_DESIGN.md)
+- [Performance Guide](PERFORMANCE_OPTIMIZATIONS.md)
+
+## 🙏 Acknowledgments
+
+TunaCode is built on the foundation of [sidekick-cli](https://github.com/geekforbrains/sidekick-cli). Special thanks to:
+- The sidekick-cli team for the original codebase
+- [TinyAgent](https://github.com/alchemiststudiosDOTai/tinyAgent) for the robust agent framework
+- The open-source community for feedback and contributions
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+**Note**: TunaCode is in active development. Please [report issues](https://github.com/larock22/tunacode/issues) or share feedback!

{tunacode_cli-0.0.5 → tunacode_cli-0.0.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tunacode-cli"
-version = "0.0.5"
+version = "0.0.6"
 description = "Your agentic CLI developer."
 keywords = ["cli", "agent", "development", "automation"]
 readme = "README.md"
@@ -26,10 +26,11 @@ classifiers = [
 ]
 dependencies = [
     "prompt_toolkit==3.0.51",
-    "pydantic-ai[logfire]==0.2.6",
+    "tiny_agent_os>=0.1.0",
     "pygments==2.19.1",
     "rich==14.0.0",
     "typer==0.15.3",
+    "pyyaml>=6.0",
 ]
 
 [project.scripts]

{tunacode_cli-0.0.5 → tunacode_cli-0.0.6}/src/tunacode/cli/commands.py

@@ -6,7 +6,6 @@ from enum import Enum
 from typing import Any, Dict, List, Optional, Type
 
 from .. import utils
-from ..configuration.models import ModelRegistry
 from ..exceptions import ValidationError
 from ..services.undo_service import perform_undo
 from ..types import CommandArgs, CommandContext, CommandResult, ProcessRequestCallback
@@ -260,7 +259,6 @@ class UndoCommand(SimpleCommand):
                 await ui.muted("   • File operations will still work, but can't be undone")
 
 
-
 class BranchCommand(SimpleCommand):
     """Create and switch to a new git branch."""
 
@@ -388,46 +386,106 @@ class ModelCommand(SimpleCommand):
         super().__init__(
             CommandSpec(
                 name="model",
-                aliases=["/model"],
-                description="List models or select a model (e.g., /model 3 or /model 3 default)",
+                aliases=["/model", "/m"],
+                description="List and select AI models interactively",
                 category=CommandCategory.MODEL,
             )
         )
 
     async def execute(self, args: CommandArgs, context: CommandContext) -> Optional[str]:
+        from tunacode.cli.model_selector import ModelSelector
+
+        selector = ModelSelector()
+
         if not args:
-            # No arguments - list models
-            await ui.models(context.state_manager)
+            # No arguments - show enhanced model list
+            await self._show_model_list(selector, context.state_manager)
             return None
 
-        # Parse model index
-        try:
-            model_index = int(args[0])
-        except ValueError:
-            await ui.error(f"Invalid model index: {args[0]}")
-            return None
+        # Find model by query (index, name, or fuzzy match)
+        query = args[0]
+        model_info = selector.find_model(query)
 
-        # Get model list
-        model_registry = ModelRegistry()
-        models = list(model_registry.list_models().keys())
-        if model_index < 0 or model_index >= len(models):
-            await ui.error(f"Model index {model_index} out of range")
+        if not model_info:
+            # Try to provide helpful suggestions
+            await ui.error(f"Model '{query}' not found")
+            await ui.muted(
+                "Try: /model (to list all), or use a number 0-18, "
+                "or model name like 'opus' or 'gpt-4'"
+            )
             return None
 
         # Set the model
-        model = models[model_index]
-        context.state_manager.session.current_model = model
+        context.state_manager.session.current_model = model_info.id
 
         # Check if setting as default
         if len(args) > 1 and args[1] == "default":
-            utils.user_configuration.set_default_model(model, context.state_manager)
-            await ui.muted("Updating default model")
+            utils.user_configuration.set_default_model(model_info.id, context.state_manager)
+            await ui.success(
+                f"Set default model: {model_info.display_name} {model_info.provider.value[2]}"
+            )
             return "restart"
         else:
-            # Show success message with the new model
-            await ui.success(f"Switched to model: {model}")
+            # Show success message with model details
+            cost_emoji = selector.get_cost_emoji(model_info.cost_tier)
+            await ui.success(
+                f"Switched to: {model_info.display_name} "
+                f"{model_info.provider.value[2]} {cost_emoji}\n"
+                f"  → {model_info.description}"
+            )
             return None
 
+    async def _show_model_list(self, selector, state_manager) -> None:
+        """Show enhanced model list grouped by provider."""
+        from rich.table import Table
+        from rich.text import Text
+
+        # Create table
+        table = Table(show_header=True, box=None, padding=(0, 2))
+        table.add_column("ID", style="dim", width=3)
+        table.add_column("Model", style="bold")
+        table.add_column("Short", style="cyan")
+        table.add_column("Description", style="dim")
+        table.add_column("Cost", justify="center", width=4)
+
+        # Current model
+        current_model = state_manager.session.current_model if state_manager else None
+
+        # Add models grouped by provider
+        model_index = 0
+        grouped = selector.get_models_by_provider()
+
+        for provider in [p for p in grouped if grouped[p]]:  # Only show providers with models
+            # Add provider header
+            table.add_row(
+                "",
+                Text(f"{provider.value[2]} {provider.value[1]}", style="bold magenta"),
+                "",
+                "",
+                "",
+            )
+
+            # Add models for this provider
+            for model in grouped[provider]:
+                is_current = model.id == current_model
+                style = "bold green" if is_current else ""
+
+                table.add_row(
+                    str(model_index),
+                    Text(model.display_name + (" ← current" if is_current else ""), style=style),
+                    model.short_name,
+                    model.description,
+                    selector.get_cost_emoji(model.cost_tier),
+                )
+                model_index += 1
+
+        # Show the table
+        await ui.panel("Available Models", table, border_style="cyan")
+
+        # Show usage hints
+        await ui.muted("\n💡 Usage: /model <number|name> [default]")
+        await ui.muted("   Examples: /model 3, /model opus, /model gpt-4 default")
+
 
 @dataclass
 class CommandDependencies:
@@ -488,8 +546,7 @@ class CommandRegistry:
         category_commands = self._categories[command.category]
         # Remove any existing instance of this command class
         self._categories[command.category] = [
-            cmd for cmd in category_commands 
-            if cmd.__class__ != command.__class__
+            cmd for cmd in category_commands if cmd.__class__ != command.__class__
         ]
         # Add the new instance
         self._categories[command.category].append(command)
@@ -533,7 +590,7 @@ class CommandRegistry:
         # Only update if callback has changed
         if self._factory.dependencies.process_request_callback == callback:
             return
-            
+
         self._factory.update_dependencies(process_request_callback=callback)
 
         # Re-register CompactCommand with new dependency if already registered
@@ -568,10 +625,10 @@ class CommandRegistry:
         if command_name in self._commands:
             command = self._commands[command_name]
             return await command.execute(args, context)
-        
+
         # Try partial matching
         matches = self.find_matching_commands(command_name)
-        
+
         if not matches:
             raise ValidationError(f"Unknown command: {command_name}")
         elif len(matches) == 1:
@@ -581,16 +638,17 @@ class CommandRegistry:
         else:
             # Ambiguous - show possibilities
             raise ValidationError(
-                f"Ambiguous command '{command_name}'. Did you mean: {', '.join(sorted(set(matches)))}?"
+                f"Ambiguous command '{command_name}'. Did you mean: "
+                f"{', '.join(sorted(set(matches)))}?"
             )
 
     def find_matching_commands(self, partial_command: str) -> List[str]:
         """
         Find all commands that start with the given partial command.
-        
+
         Args:
             partial_command: The partial command to match
-            
+
         Returns:
             List of matching command names
         """
@@ -608,11 +666,11 @@ class CommandRegistry:
             return False
 
         command_name = parts[0].lower()
-        
+
         # Check exact match first
         if command_name in self._commands:
             return True
-            
+
         # Check partial match
         return len(self.find_matching_commands(command_name)) > 0