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

{tunacode_cli-0.0.6 → tunacode_cli-0.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tunacode-cli
-Version: 0.0.6
+Version: 0.0.8
 Summary: Your agentic CLI developer.
 Author-email: larock22 <noreply@github.com>
 License-Expression: MIT
@@ -23,7 +23,7 @@ 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: typer==0.12.5
 Requires-Dist: pyyaml>=6.0
 Provides-Extra: dev
 Requires-Dist: build; extra == "dev"
@@ -71,16 +71,48 @@ Dynamic: license-file
 
 ## 🚀 Quick Start
 
+### One-Line Install (Linux/macOS)
+
+```bash
+# Using curl
+curl -sSL https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
+
+# Or using wget
+wget -qO- https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
+```
+
+This creates a virtual environment in `~/.tunacode-venv` and adds the `tunacode` command to your PATH.
+
+### Alternative Install Methods
+
 ```bash
 # Install from PyPI
 pip install tunacode-cli
 
+# Or install globally using pipx (recommended)
+python3 -m pip install --user pipx
+python3 -m pipx ensurepath
+pipx install tunacode-cli
+```
+
+### Start Using TunaCode
+
+```bash
 # Run setup (first time only)
 tunacode
 
 # Start coding!
 tunacode
 > Help me refactor this codebase to use async/await
+
+# Update to latest version
+tunacode --update
+
+# Start with a specific model
+tunacode --model openrouter:openai/gpt-4o-mini
+
+# Use a custom OpenAI-compatible API endpoint
+tunacode --base-url https://your-api.com/v1 --model custom:gpt-4
 ```
 
 ## 📋 Commands
@@ -94,6 +126,7 @@ tunacode
 | `/branch <name>` | Create new git branch | `/branch feature/auth` |
 | `/compact` | Summarize and trim history | `/compact` |
 | `/help` | Show all commands | `/help` |
+| `--update` | Update to latest version | `tunacode --update` |
 
 ## 🔧 Configuration
 
@@ -117,19 +150,72 @@ Configuration is stored in `~/.config/tunacode.json`:
 }
 ```
 
+### Environment Variables
+
+TunaCode automatically loads environment variables from a `.env` file in your current directory:
+
+```bash
+# .env file
+OPENAI_API_KEY=sk-...
+OPENROUTER_API_KEY=sk-or-v1-...
+ANTHROPIC_API_KEY=sk-ant-...
+```
+
+Environment variables take precedence over config file values.
+
+### TinyAgent Configuration
+
+TunaCode uses [TinyAgent](https://github.com/alchemiststudiosDOTai/tiny_agent_os) under the hood. Advanced configuration is stored in `~/.config/tunacode_config.yml`:
+
+```yaml
+# Model and API configuration
+base_url: ${OPENAI_BASE_URL:-https://api.openai.com/v1}
+model:
+  default: "gpt-4o"  # Overridden by TunaCode's model selection
+
+# File operations
+file_operations:
+  max_file_size: 10_485_760  # 10 MB
+  allow_overwrite: true
+
+# Retry configuration
+retries:
+  max_attempts: 3
+  temperature: { initial: 0.2, increment: 0.3, max: 0.8 }
+```
+
+This file is automatically created during installation. Most users won't need to modify it.
+
 ### 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
+# Add your OpenRouter API key to config or .env file
+# TunaCode automatically sets the correct base URL for OpenRouter models
 
 # Use any OpenRouter model:
+tunacode --model openrouter:openai/gpt-4o-mini
+tunacode --model openrouter:anthropic/claude-3.5-sonnet
+
+# Or switch models inside TunaCode:
 /model openrouter:anthropic/claude-3-opus
 /model openrouter:mistralai/devstral-small
 /model openrouter:openai/gpt-4.1
 ```
 
+### OpenAI-Compatible APIs
+
+TunaCode supports any OpenAI-compatible API endpoint. The `--base-url` flag overrides the API endpoint for providers that use the OpenAI API format:
+
+```bash
+# Use a local LLM server
+tunacode --base-url http://localhost:8080/v1 --model local:llama2
+
+# Use alternative OpenAI-compatible services
+tunacode --base-url https://api.together.ai/v1 --model together:llama-2-70b
+```
+
+**Note**: The base URL override only works with OpenAI-compatible APIs that follow the same request/response format as OpenAI's API.
+
 ## 🛡️ Undo System
 
 TunaCode provides **three layers of protection** for your files:

{tunacode_cli-0.0.6 → tunacode_cli-0.0.8}/README.md

@@ -35,16 +35,48 @@
 
 ## 🚀 Quick Start
 
+### One-Line Install (Linux/macOS)
+
+```bash
+# Using curl
+curl -sSL https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
+
+# Or using wget
+wget -qO- https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
+```
+
+This creates a virtual environment in `~/.tunacode-venv` and adds the `tunacode` command to your PATH.
+
+### Alternative Install Methods
+
 ```bash
 # Install from PyPI
 pip install tunacode-cli
 
+# Or install globally using pipx (recommended)
+python3 -m pip install --user pipx
+python3 -m pipx ensurepath
+pipx install tunacode-cli
+```
+
+### Start Using TunaCode
+
+```bash
 # Run setup (first time only)
 tunacode
 
 # Start coding!
 tunacode
 > Help me refactor this codebase to use async/await
+
+# Update to latest version
+tunacode --update
+
+# Start with a specific model
+tunacode --model openrouter:openai/gpt-4o-mini
+
+# Use a custom OpenAI-compatible API endpoint
+tunacode --base-url https://your-api.com/v1 --model custom:gpt-4
 ```
 
 ## 📋 Commands
@@ -58,6 +90,7 @@ tunacode
 | `/branch <name>` | Create new git branch | `/branch feature/auth` |
 | `/compact` | Summarize and trim history | `/compact` |
 | `/help` | Show all commands | `/help` |
+| `--update` | Update to latest version | `tunacode --update` |
 
 ## 🔧 Configuration
 
@@ -81,19 +114,72 @@ Configuration is stored in `~/.config/tunacode.json`:
 }
 ```
 
+### Environment Variables
+
+TunaCode automatically loads environment variables from a `.env` file in your current directory:
+
+```bash
+# .env file
+OPENAI_API_KEY=sk-...
+OPENROUTER_API_KEY=sk-or-v1-...
+ANTHROPIC_API_KEY=sk-ant-...
+```
+
+Environment variables take precedence over config file values.
+
+### TinyAgent Configuration
+
+TunaCode uses [TinyAgent](https://github.com/alchemiststudiosDOTai/tiny_agent_os) under the hood. Advanced configuration is stored in `~/.config/tunacode_config.yml`:
+
+```yaml
+# Model and API configuration
+base_url: ${OPENAI_BASE_URL:-https://api.openai.com/v1}
+model:
+  default: "gpt-4o"  # Overridden by TunaCode's model selection
+
+# File operations
+file_operations:
+  max_file_size: 10_485_760  # 10 MB
+  allow_overwrite: true
+
+# Retry configuration
+retries:
+  max_attempts: 3
+  temperature: { initial: 0.2, increment: 0.3, max: 0.8 }
+```
+
+This file is automatically created during installation. Most users won't need to modify it.
+
 ### 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
+# Add your OpenRouter API key to config or .env file
+# TunaCode automatically sets the correct base URL for OpenRouter models
 
 # Use any OpenRouter model:
+tunacode --model openrouter:openai/gpt-4o-mini
+tunacode --model openrouter:anthropic/claude-3.5-sonnet
+
+# Or switch models inside TunaCode:
 /model openrouter:anthropic/claude-3-opus
 /model openrouter:mistralai/devstral-small
 /model openrouter:openai/gpt-4.1
 ```
 
+### OpenAI-Compatible APIs
+
+TunaCode supports any OpenAI-compatible API endpoint. The `--base-url` flag overrides the API endpoint for providers that use the OpenAI API format:
+
+```bash
+# Use a local LLM server
+tunacode --base-url http://localhost:8080/v1 --model local:llama2
+
+# Use alternative OpenAI-compatible services
+tunacode --base-url https://api.together.ai/v1 --model together:llama-2-70b
+```
+
+**Note**: The base URL override only works with OpenAI-compatible APIs that follow the same request/response format as OpenAI's API.
+
 ## 🛡️ Undo System
 
 TunaCode provides **three layers of protection** for your files:

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tunacode-cli"
-version = "0.0.6"
+version = "0.0.8"
 description = "Your agentic CLI developer."
 keywords = ["cli", "agent", "development", "automation"]
 readme = "README.md"
@@ -29,7 +29,7 @@ dependencies = [
     "tiny_agent_os>=0.1.0",
     "pygments==2.19.1",
     "rich==14.0.0",
-    "typer==0.15.3",
+    "typer==0.12.5",
     "pyyaml>=6.0",
 ]
 

tunacode_cli-0.0.8/src/tunacode/cli/main.py

@@ -0,0 +1,82 @@
+"""
+Module: sidekick.cli.main
+
+CLI entry point and main command handling for the Sidekick application.
+Manages application startup, version checking, and REPL initialization.
+"""
+
+import asyncio
+import os
+from pathlib import Path
+
+import typer
+
+from tunacode.cli.repl import repl
+from tunacode.configuration.settings import ApplicationSettings
+from tunacode.core.state import StateManager
+from tunacode.setup import setup
+from tunacode.ui import console as ui
+from tunacode.utils.system import check_for_updates
+
+app_settings = ApplicationSettings()
+state_manager = StateManager()
+
+
+def main(
+    version: bool = typer.Option(False, "--version", "-v", help="Show version and exit."),
+    run_setup: bool = typer.Option(False, "--setup", help="Run setup process."),
+    update: bool = typer.Option(False, "--update", "--upgrade", help="Update TunaCode to the latest version."),
+    model: str = typer.Option(None, "--model", "-m", help="Set the model to use (e.g., 'openai:gpt-4o', 'openrouter:anthropic/claude-3.5-sonnet')."),
+    base_url: str = typer.Option(None, "--base-url", help="Override the API base URL for OpenAI-compatible endpoints (e.g., 'https://openrouter.ai/api/v1')."),
+):
+    """TunaCode - Your agentic CLI developer."""
+    # Load .env file if it exists
+    env_file = Path(".env")
+    if env_file.exists():
+        try:
+            from dotenv import load_dotenv
+            load_dotenv()
+        except ImportError:
+            # dotenv not installed, skip loading
+            pass
+    if version:
+        asyncio.run(ui.version())
+        return
+    
+    if update:
+        from tunacode.utils.system import update_tunacode
+        asyncio.run(update_tunacode())
+        return
+
+    # Apply CLI overrides to state manager before setup
+    if model:
+        state_manager.session.model = model
+        state_manager.session.user_config["default_model"] = model
+    
+    if base_url:
+        import os
+        os.environ["OPENAI_BASE_URL"] = base_url
+
+    asyncio.run(ui.banner())
+
+    has_update, latest_version = check_for_updates()
+    if has_update:
+        asyncio.run(ui.show_update_message(latest_version))
+
+    try:
+        asyncio.run(setup(run_setup, state_manager))
+        asyncio.run(repl(state_manager))
+    except Exception as e:
+        asyncio.run(ui.error(str(e)))
+
+
+app = typer.Typer(
+    name="tunacode",
+    help="TunaCode - Your agentic CLI developer",
+    add_completion=False,
+)
+
+app.command()(main)
+
+if __name__ == "__main__":
+    app()

{tunacode_cli-0.0.6 → tunacode_cli-0.0.8}/src/tunacode/constants.py

@@ -7,7 +7,7 @@ Centralizes all magic strings, UI text, error messages, and application constant
 
 # Application info
 APP_NAME = "TunaCode"
-APP_VERSION = "0.1.0"
+APP_VERSION = "0.0.8"
 
 # File patterns
 GUIDE_FILE_PATTERN = "{name}.md"

{tunacode_cli-0.0.6 → tunacode_cli-0.0.8}/src/tunacode/core/agents/tinyagent_main.py

@@ -1,15 +1,36 @@
 """TinyAgent-based agent implementation."""
 
+import os
 from contextlib import asynccontextmanager
 from datetime import datetime, timezone
+from pathlib import Path
 from typing import Any, Dict, Optional
 
-from tinyagent.react.react_agent import ReactAgent
+from tinyagent import ReactAgent
 
 from tunacode.core.state import StateManager
 from tunacode.tools.tinyagent_tools import read_file, run_command, update_file, write_file
 from tunacode.types import ModelName, ToolCallback
 
+# Set up tinyagent configuration
+# First check if config exists in the package directory
+_package_dir = Path(__file__).parent.parent.parent.parent  # Navigate to tunacode root
+_config_candidates = [
+    _package_dir / "tunacode_config.yml",  # In package root
+    Path.home() / ".config" / "tunacode_config.yml",  # In user config dir
+    Path.cwd() / "tunacode_config.yml",  # In current directory
+]
+
+# Find the first existing config file
+for config_path in _config_candidates:
+    if config_path.exists():
+        os.environ["TINYAGENT_CONFIG"] = str(config_path)
+        break
+else:
+    # If no config found, we'll rely on tinyagent to handle it
+    # This prevents the immediate error on import
+    pass
+
 
 def get_or_create_react_agent(model: ModelName, state_manager: StateManager) -> ReactAgent:
     """
@@ -58,12 +79,9 @@ def get_or_create_react_agent(model: ModelName, state_manager: StateManager) ->
                 if state_manager.session.user_config["env"].get(key_name):
                     os.environ[key_name] = state_manager.session.user_config["env"][key_name]
 
-        # Create new ReactAgent with the actual model name
-        agent = ReactAgent(model_override=actual_model)
-
-        # Register our tools
-        for fn in (read_file, write_file, update_file, run_command):
-            agent.register_tool(fn._tool)
+        # Create new ReactAgent with tools
+        # Note: tinyAgent gets model from environment variables, not constructor
+        agent = ReactAgent(tools=[read_file, write_file, update_file, run_command])
 
         # Add MCP compatibility method
         @asynccontextmanager
@@ -106,7 +124,12 @@ async def process_request_with_tinyagent(
 
     try:
         # Run the agent with the message
-        result = await agent.run_react(message)
+        # The new API's run() method might be synchronous based on the examples
+        import asyncio
+        if asyncio.iscoroutinefunction(agent.run):
+            result = await agent.run(message)
+        else:
+            result = agent.run(message)
 
         # Update message history in state_manager
         # This will need to be adapted based on how tinyAgent returns messages

{tunacode_cli-0.0.6 → tunacode_cli-0.0.8}/src/tunacode/core/setup/config_setup.py

@@ -65,14 +65,14 @@ class ConfigSetup(BaseSetup):
         # Check if the configured model still exists
         default_model = self.state_manager.session.user_config["default_model"]
         if not self.model_registry.get_model(default_model):
+            # If model not found, run the onboarding again
             await ui.panel(
                 "Model Not Found",
                 f"The configured model '[bold]{default_model}[/bold]' is no longer available.\n"
-                "Please select a new default model.",
+                "Let's reconfigure your setup.",
                 border_style=UI_COLORS["warning"],
             )
-            await self._step2_default_model()
-            user_configuration.save_config(self.state_manager)
+            await self._onboarding()
 
         self.state_manager.session.current_model = self.state_manager.session.user_config[
             "default_model"
@@ -114,66 +114,74 @@ class ConfigSetup(BaseSetup):
         """Run the onboarding process for new users."""
         initial_config = json.dumps(self.state_manager.session.user_config, sort_keys=True)
 
-        await self._step1_api_keys()
-
-        # Only continue if at least one API key was provided
-        env = self.state_manager.session.user_config.get("env", {})
-        has_api_key = any(key.endswith("_API_KEY") and env.get(key) for key in env)
+        # Welcome message
+        message = (
+            f"Welcome to {APP_NAME}!\n\n"
+            "Let's configure your AI provider. TunaCode supports:\n"
+            "• OpenAI (api.openai.com)\n"
+            "• OpenRouter (openrouter.ai) - Access 100+ models\n"
+            "• Any OpenAI-compatible API\n"
+        )
+        await ui.panel("Setup", message, border_style=UI_COLORS["primary"])
 
-        if has_api_key:
-            if not self.state_manager.session.user_config.get("default_model"):
-                await self._step2_default_model()
+        # Step 1: Ask for base URL
+        base_url = await ui.input(
+            "step1",
+            pretext="  API Base URL (press Enter for OpenAI): ",
+            default="https://api.openai.com/v1",
+            state_manager=self.state_manager,
+        )
+        base_url = base_url.strip()
+        if not base_url:
+            base_url = "https://api.openai.com/v1"
+
+        # Step 2: Ask for API key
+        if "openrouter.ai" in base_url.lower():
+            key_prompt = "  OpenRouter API Key: "
+            key_name = "OPENROUTER_API_KEY"
+            default_model = "openrouter:openai/gpt-4o-mini"
+        else:
+            key_prompt = "  API Key: "
+            key_name = "OPENAI_API_KEY"
+            default_model = "openai:gpt-4o"
 
-            # Compare configs to see if anything changed
+        api_key = await ui.input(
+            "step2",
+            pretext=key_prompt,
+            is_password=True,
+            state_manager=self.state_manager,
+        )
+        api_key = api_key.strip()
+
+        if api_key:
+            # Set the environment variable
+            self.state_manager.session.user_config["env"][key_name] = api_key
+            
+            # Set base URL in environment for OpenRouter
+            if "openrouter.ai" in base_url.lower():
+                import os
+                os.environ["OPENAI_BASE_URL"] = base_url
+            
+            # Set default model
+            self.state_manager.session.user_config["default_model"] = default_model
+
+            # Save configuration
             current_config = json.dumps(self.state_manager.session.user_config, sort_keys=True)
             if initial_config != current_config:
                 if user_configuration.save_config(self.state_manager):
-                    message = f"Config saved to: [bold]{self.config_file}[/bold]"
-                    await ui.panel("Finished", message, top=0, border_style=UI_COLORS["success"])
+                    message = (
+                        f"✅ Configuration saved!\n\n"
+                        f"Default model: {default_model}\n"
+                        f"Config file: {self.config_file}\n\n"
+                        f"You can change models anytime with /model"
+                    )
+                    await ui.panel("Setup Complete", message, top=0, border_style=UI_COLORS["success"])
                 else:
                     await ui.error("Failed to save configuration.")
         else:
             await ui.panel(
                 "Setup canceled",
-                "At least one API key is required.",
+                "An API key is required to use TunaCode.",
                 border_style=UI_COLORS["warning"],
             )
 
-    async def _step1_api_keys(self):
-        """Onboarding step 1: Collect API keys."""
-        message = (
-            f"Welcome to {APP_NAME}!\n"
-            "Let's get you setup. First, we'll need to set some environment variables.\n"
-            "Skip the ones you don't need."
-        )
-        await ui.panel("Setup", message, border_style=UI_COLORS["primary"])
-        env_keys = self.state_manager.session.user_config["env"].copy()
-        for key in env_keys:
-            provider = key_to_title(key)
-            val = await ui.input(
-                "step1",
-                pretext=f"  {provider}: ",
-                is_password=True,
-                state_manager=self.state_manager,
-            )
-            val = val.strip()
-            if val:
-                self.state_manager.session.user_config["env"][key] = val
-
-    async def _step2_default_model(self):
-        """Onboarding step 2: Select default model."""
-        message = "Which model would you like to use by default?\n\n"
-
-        model_ids = self.model_registry.list_model_ids()
-        for index, model_id in enumerate(model_ids):
-            message += f"  {index} - {model_id}\n"
-        message = message.strip()
-
-        await ui.panel("Default Model", message, border_style=UI_COLORS["primary"])
-        choice = await ui.input(
-            "step2",
-            pretext="  Default model (#): ",
-            validator=ui.ModelValidator(len(model_ids)),
-            state_manager=self.state_manager,
-        )
-        self.state_manager.session.user_config["default_model"] = model_ids[int(choice)]

{tunacode_cli-0.0.6 → tunacode_cli-0.0.8}/src/tunacode/tools/tinyagent_tools.py

@@ -2,7 +2,7 @@
 
 from typing import Optional
 
-from tinyagent.decorators import tool
+from tinyagent import tool
 
 from tunacode.exceptions import ToolExecutionError
 from tunacode.ui import console as ui

{tunacode_cli-0.0.6 → tunacode_cli-0.0.8}/src/tunacode/ui/input.py

@@ -32,6 +32,7 @@ async def input(
     lexer=None,
     timeoutlen: float = 0.05,
     state_manager: Optional[StateManager] = None,
+    default: str = "",
 ) -> str:
     """
     Prompt for user input using simplified prompt management.
@@ -48,6 +49,7 @@ async def input(
         lexer: Optional lexer for syntax highlighting
         timeoutlen: Timeout length for input
         state_manager: The state manager for session storage
+        default: Default value to pre-fill in the input
 
     Returns:
         User input string
@@ -62,6 +64,7 @@ async def input(
         completer=completer,
         lexer=lexer,
         timeoutlen=timeoutlen,
+        default=default,
     )
 
     # Create prompt manager

{tunacode_cli-0.0.6 → tunacode_cli-0.0.8}/src/tunacode/ui/prompt_manager.py

@@ -28,6 +28,7 @@ class PromptConfig:
     completer: Optional[Completer] = None
     lexer: Optional[Lexer] = None
     timeoutlen: float = 0.05
+    default: str = ""
 
 
 class PromptManager:
@@ -107,6 +108,7 @@ class PromptManager:
                 is_password=config.is_password,
                 validator=config.validator,
                 multiline=config.multiline,
+                default=config.default,
             )
 
             # Clean up response

{tunacode_cli-0.0.6 → tunacode_cli-0.0.8}/src/tunacode/utils/system.py

@@ -277,6 +277,46 @@ def check_for_updates():
         return False, current_version
 
 
+async def update_tunacode():
+    """
+    Update TunaCode to the latest version using pip.
+    """
+    from ..ui import console as ui
+    
+    await ui.info("🔄 Checking for updates...")
+    
+    has_update, latest_version = check_for_updates()
+    
+    if not has_update:
+        await ui.success("✅ TunaCode is already up to date!")
+        return
+    
+    app_settings = ApplicationSettings()
+    current_version = app_settings.version
+    
+    await ui.info(f"📦 Updating from v{current_version} to v{latest_version}...")
+    
+    try:
+        # Run pip install --upgrade tunacode-cli
+        result = subprocess.run(
+            ["pip", "install", "--upgrade", "tunacode-cli"],
+            capture_output=True,
+            text=True,
+            check=True
+        )
+        
+        if result.returncode == 0:
+            await ui.success(f"🎉 Successfully updated to v{latest_version}!")
+            await ui.info("Please restart TunaCode to use the new version.")
+        else:
+            await ui.error(f"❌ Update failed: {result.stderr}")
+            
+    except subprocess.CalledProcessError as e:
+        await ui.error(f"❌ Update failed: {e.stderr}")
+    except Exception as e:
+        await ui.error(f"❌ Update failed: {str(e)}")
+
+
 def list_cwd(max_depth=3):
     """
     Lists files in the current working directory up to a specified depth,

{tunacode_cli-0.0.6 → tunacode_cli-0.0.8}/src/tunacode_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tunacode-cli
-Version: 0.0.6
+Version: 0.0.8
 Summary: Your agentic CLI developer.
 Author-email: larock22 <noreply@github.com>
 License-Expression: MIT
@@ -23,7 +23,7 @@ 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: typer==0.12.5
 Requires-Dist: pyyaml>=6.0
 Provides-Extra: dev
 Requires-Dist: build; extra == "dev"
@@ -71,16 +71,48 @@ Dynamic: license-file
 
 ## 🚀 Quick Start
 
+### One-Line Install (Linux/macOS)
+
+```bash
+# Using curl
+curl -sSL https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
+
+# Or using wget
+wget -qO- https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
+```
+
+This creates a virtual environment in `~/.tunacode-venv` and adds the `tunacode` command to your PATH.
+
+### Alternative Install Methods
+
 ```bash
 # Install from PyPI
 pip install tunacode-cli
 
+# Or install globally using pipx (recommended)
+python3 -m pip install --user pipx
+python3 -m pipx ensurepath
+pipx install tunacode-cli
+```
+
+### Start Using TunaCode
+
+```bash
 # Run setup (first time only)
 tunacode
 
 # Start coding!
 tunacode
 > Help me refactor this codebase to use async/await
+
+# Update to latest version
+tunacode --update
+
+# Start with a specific model
+tunacode --model openrouter:openai/gpt-4o-mini
+
+# Use a custom OpenAI-compatible API endpoint
+tunacode --base-url https://your-api.com/v1 --model custom:gpt-4
 ```
 
 ## 📋 Commands
@@ -94,6 +126,7 @@ tunacode
 | `/branch <name>` | Create new git branch | `/branch feature/auth` |
 | `/compact` | Summarize and trim history | `/compact` |
 | `/help` | Show all commands | `/help` |
+| `--update` | Update to latest version | `tunacode --update` |
 
 ## 🔧 Configuration
 
@@ -117,19 +150,72 @@ Configuration is stored in `~/.config/tunacode.json`:
 }
 ```
 
+### Environment Variables
+
+TunaCode automatically loads environment variables from a `.env` file in your current directory:
+
+```bash
+# .env file
+OPENAI_API_KEY=sk-...
+OPENROUTER_API_KEY=sk-or-v1-...
+ANTHROPIC_API_KEY=sk-ant-...
+```
+
+Environment variables take precedence over config file values.
+
+### TinyAgent Configuration
+
+TunaCode uses [TinyAgent](https://github.com/alchemiststudiosDOTai/tiny_agent_os) under the hood. Advanced configuration is stored in `~/.config/tunacode_config.yml`:
+
+```yaml
+# Model and API configuration
+base_url: ${OPENAI_BASE_URL:-https://api.openai.com/v1}
+model:
+  default: "gpt-4o"  # Overridden by TunaCode's model selection
+
+# File operations
+file_operations:
+  max_file_size: 10_485_760  # 10 MB
+  allow_overwrite: true
+
+# Retry configuration
+retries:
+  max_attempts: 3
+  temperature: { initial: 0.2, increment: 0.3, max: 0.8 }
+```
+
+This file is automatically created during installation. Most users won't need to modify it.
+
 ### 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
+# Add your OpenRouter API key to config or .env file
+# TunaCode automatically sets the correct base URL for OpenRouter models
 
 # Use any OpenRouter model:
+tunacode --model openrouter:openai/gpt-4o-mini
+tunacode --model openrouter:anthropic/claude-3.5-sonnet
+
+# Or switch models inside TunaCode:
 /model openrouter:anthropic/claude-3-opus
 /model openrouter:mistralai/devstral-small
 /model openrouter:openai/gpt-4.1
 ```
 
+### OpenAI-Compatible APIs
+
+TunaCode supports any OpenAI-compatible API endpoint. The `--base-url` flag overrides the API endpoint for providers that use the OpenAI API format:
+
+```bash
+# Use a local LLM server
+tunacode --base-url http://localhost:8080/v1 --model local:llama2
+
+# Use alternative OpenAI-compatible services
+tunacode --base-url https://api.together.ai/v1 --model together:llama-2-70b
+```
+
+**Note**: The base URL override only works with OpenAI-compatible APIs that follow the same request/response format as OpenAI's API.
+
 ## 🛡️ Undo System
 
 TunaCode provides **three layers of protection** for your files:

{tunacode_cli-0.0.6 → tunacode_cli-0.0.8}/src/tunacode_cli.egg-info/SOURCES.txt

@@ -74,4 +74,5 @@ src/tunacode_cli.egg-info/SOURCES.txt
 src/tunacode_cli.egg-info/dependency_links.txt
 src/tunacode_cli.egg-info/entry_points.txt
 src/tunacode_cli.egg-info/requires.txt
-src/tunacode_cli.egg-info/top_level.txt
+src/tunacode_cli.egg-info/top_level.txt
+tests/test_import.py

{tunacode_cli-0.0.6 → tunacode_cli-0.0.8}/src/tunacode_cli.egg-info/requires.txt

@@ -2,7 +2,7 @@ prompt_toolkit==3.0.51
 tiny_agent_os>=0.1.0
 pygments==2.19.1
 rich==14.0.0
-typer==0.15.3
+typer==0.12.5
 pyyaml>=6.0
 
 [dev]

tunacode_cli-0.0.8/tests/test_import.py

@@ -0,0 +1,7 @@
+import os
+import sys
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+
+def test_import_constants():
+    import tunacode.constants

tunacode_cli-0.0.6/src/tunacode/cli/main.py

@@ -1,47 +0,0 @@
-"""
-Module: sidekick.cli.main
-
-CLI entry point and main command handling for the Sidekick application.
-Manages application startup, version checking, and REPL initialization.
-"""
-
-import asyncio
-
-import typer
-
-from tunacode.cli.repl import repl
-from tunacode.configuration.settings import ApplicationSettings
-from tunacode.core.state import StateManager
-from tunacode.setup import setup
-from tunacode.ui import console as ui
-from tunacode.utils.system import check_for_updates
-
-app_settings = ApplicationSettings()
-app = typer.Typer(help=app_settings.name)
-state_manager = StateManager()
-
-
-@app.command()
-def main(
-    version: bool = typer.Option(False, "--version", "-v", help="Show version and exit."),
-    run_setup: bool = typer.Option(False, "--setup", help="Run setup process."),
-):
-    if version:
-        asyncio.run(ui.version())
-        return
-
-    asyncio.run(ui.banner())
-
-    has_update, latest_version = check_for_updates()
-    if has_update:
-        asyncio.run(ui.show_update_message(latest_version))
-
-    try:
-        asyncio.run(setup(run_setup, state_manager))
-        asyncio.run(repl(state_manager))
-    except Exception as e:
-        asyncio.run(ui.error(str(e)))
-
-
-if __name__ == "__main__":
-    app()