tunacode-cli 0.0.26__py3-none-any.whl → 0.0.28__py3-none-any.whl

tunacode/cli/commands.py

@@ -521,13 +521,92 @@ class CompactCommand(SimpleCommand):
             await ui.error("Compact command not available - process_request not configured")
             return
 
-        # Get the current agent, create a summary of context, and trim message history
-        await process_request(
-            "Summarize the conversation so far", context.state_manager, output=False
+        # Count current messages
+        original_count = len(context.state_manager.session.messages)
+
+        # Generate summary with output captured
+        summary_prompt = (
+            "Summarize the conversation so far in a concise paragraph, "
+            "focusing on the main topics discussed and any important context "
+            "that should be preserved."
         )
-        await ui.success("Context history has been summarized and truncated.")
+        result = await process_request(
+            summary_prompt,
+            context.state_manager,
+            output=False,  # We'll handle the output ourselves
+        )
+
+        # Extract summary text from result
+        summary_text = ""
+
+        # First try: standard result structure
+        if (
+            result
+            and hasattr(result, "result")
+            and result.result
+            and hasattr(result.result, "output")
+        ):
+            summary_text = result.result.output
+
+        # Second try: check messages for assistant response
+        if not summary_text:
+            messages = context.state_manager.session.messages
+            # Look through new messages in reverse order
+            for i in range(len(messages) - 1, original_count - 1, -1):
+                msg = messages[i]
+                # Handle ModelResponse objects
+                if hasattr(msg, "parts") and msg.parts:
+                    for part in msg.parts:
+                        if hasattr(part, "content") and part.content:
+                            content = part.content
+                            # Skip JSON thought objects
+                            if content.strip().startswith('{"thought"'):
+                                lines = content.split("\n")
+                                # Find the actual summary after the JSON
+                                for i, line in enumerate(lines):
+                                    if (
+                                        line.strip()
+                                        and not line.strip().startswith("{")
+                                        and not line.strip().endswith("}")
+                                    ):
+                                        summary_text = "\n".join(lines[i:]).strip()
+                                        break
+                            else:
+                                summary_text = content
+                            if summary_text:
+                                break
+                # Handle dict-style messages
+                elif isinstance(msg, dict):
+                    if msg.get("role") == "assistant" and msg.get("content"):
+                        summary_text = msg["content"]
+                        break
+                # Handle other message types
+                elif hasattr(msg, "content") and hasattr(msg, "role"):
+                    if getattr(msg, "role", None) == "assistant":
+                        summary_text = msg.content
+                        break
+
+                if summary_text:
+                    break
+
+        if not summary_text:
+            await ui.error("Failed to generate summary - no assistant response found")
+            return
+
+        # Display summary in a formatted panel
+        from tunacode.ui import panels
+
+        await panels.panel("Conversation Summary", summary_text, border_style="cyan")
+
+        # Show statistics
+        await ui.info(f"Current message count: {original_count}")
+        await ui.info("After compaction: 3 (summary + last 2 messages)")
+
+        # Truncate the conversation history
         context.state_manager.session.messages = context.state_manager.session.messages[-2:]
 
+        await ui.success("Context history has been summarized and truncated.")
+
 
 class UpdateCommand(SimpleCommand):
     """Update TunaCode to the latest version."""

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.0.26"
+APP_VERSION = "0.0.28"
 
 # File patterns
 GUIDE_FILE_PATTERN = "{name}.md"

tunacode/core/agents/main.py

@@ -370,6 +370,8 @@ async def process_request(
 
                     await ui.warning(f"⚠️ Reached maximum iterations ({max_iterations})")
                 break
+
+        # If we need to add a fallback response, create a wrapper
         if not response_state.has_user_response and i >= max_iterations and fallback_enabled:
             patch_tool_messages("Task incomplete", state_manager=state_manager)
             response_state.has_final_synthesis = True
@@ -378,6 +380,28 @@ async def process_request(
                 progress=f"{i}/{max_iterations} iterations completed",
             )
 
-            agent_run.result = SimpleResult(fallback.summary)
-        agent_run.response_state = response_state
-        return agent_run
+            # Create a wrapper object that mimics AgentRun with the required attributes
+            class AgentRunWrapper:
+                def __init__(self, wrapped_run, fallback_result):
+                    self._wrapped = wrapped_run
+                    self.result = fallback_result
+                    self.response_state = response_state
+
+                def __getattr__(self, name):
+                    # Delegate all other attributes to the wrapped object
+                    return getattr(self._wrapped, name)
+
+            return AgentRunWrapper(agent_run, SimpleResult(fallback.summary))
+
+        # For non-fallback cases, we still need to handle the response_state
+        # Create a minimal wrapper just to add response_state
+        class AgentRunWithState:
+            def __init__(self, wrapped_run):
+                self._wrapped = wrapped_run
+                self.response_state = response_state
+
+            def __getattr__(self, name):
+                # Delegate all other attributes to the wrapped object
+                return getattr(self._wrapped, name)
+
+        return AgentRunWithState(agent_run)

tunacode/core/agents/orchestrator.py

@@ -108,8 +108,10 @@ class OrchestratorAgent:
                 def __init__(self, output: str):
                     self.output = output
 
-            synth_run = type("SynthRun", (), {})()
-            synth_run.result = SynthResult(summary)
-            results.append(synth_run)
+            class SynthRun:
+                def __init__(self):
+                    self.result = SynthResult(summary)
+
+            results.append(SynthRun())
 
         return results

tunacode/ui/output.py

@@ -24,7 +24,7 @@ BANNER = """[bold cyan]
    ██║   ╚██████╔╝██║ ╚████║██║  ██║
    ╚═╝    ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝
 
- ██████╗ ██████╗ ██████╗ ███████╗
+ ██████╗ ██████╗ ██████╗ ███████╗  dev
 ██╔════╝██╔═══██╗██╔══██╗██╔════╝
 ██║     ██║   ██║██║  ██║█████╗
 ██║     ██║   ██║██║  ██║██╔══╝

tunacode_cli-0.0.28.dist-info/METADATA

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: tunacode-cli
+Version: 0.0.28
+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: typer==0.15.3
+Requires-Dist: prompt_toolkit==3.0.51
+Requires-Dist: pydantic-ai[logfire]==0.2.6
+Requires-Dist: pygments==2.19.1
+Requires-Dist: rich==14.0.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"
+Requires-Dist: textual-dev; extra == "dev"
+Dynamic: license-file
+
+# TunaCode
+
+<div align="center">
+
+[![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)
+
+**AI-powered CLI coding assistant**
+
+![Demo](demo.gif)
+
+</div>
+
+---
+
+## Quick Install
+
+```bash
+# Option 1: One-line install (Linux/macOS)
+wget -qO- https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
+
+# Option 2: pip install
+pip install tunacode-cli
+```
+
+## Configuration
+
+Choose your AI provider and set your API key:
+
+```bash
+# OpenAI
+tunacode --model "openai:gpt-4o" --key "sk-your-openai-key"
+
+# Anthropic Claude  
+tunacode --model "anthropic:claude-3.5-sonnet" --key "sk-ant-your-anthropic-key"
+
+# OpenRouter (100+ models)
+tunacode --model "openrouter:openai/gpt-4o" --key "sk-or-your-openrouter-key"
+```
+
+Your config is saved to `~/.config/tunacode.json`
+
+## Start Coding
+
+```bash
+tunacode
+```
+
+## Basic Commands
+
+| Command | Description |
+| ------- | ----------- |
+| `/help` | Show all commands |
+| `/model <provider:name>` | Switch model |
+| `/clear` | Clear message history |
+| `/compact` | Summarize conversation |
+| `/branch <name>` | Create Git branch |
+| `/yolo` | Skip confirmations |
+| `!<command>` | Run shell command |
+| `exit` | Exit TunaCode |
+
+## Safety First
+
+⚠️ **Important**: TunaCode can modify your codebase. Always:
+- Use Git branches before making changes
+- Review file modifications before confirming
+- Keep backups of important work
+
+## Documentation
+
+- [**Features**](documentation/FEATURES.md) - All features, tools, and commands
+- [**Advanced Configuration**](documentation/ADVANCED-CONFIG.md) - Provider setup, MCP, customization
+- [**Architecture**](documentation/ARCHITECTURE.md) - Source code organization and design
+- [**Development**](documentation/DEVELOPMENT.md) - Contributing and development setup
+
+## Links
+
+- [PyPI Package](https://pypi.org/project/tunacode-cli/)
+- [GitHub Repository](https://github.com/alchemiststudiosDOTai/tunacode)
+- [Report Issues](https://github.com/alchemiststudiosDOTai/tunacode/issues)
+
+---
+
+MIT License - see [LICENSE](LICENSE) file

{tunacode_cli-0.0.26.dist-info → tunacode_cli-0.0.28.dist-info}/RECORD

@@ -1,12 +1,12 @@
 tunacode/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tunacode/constants.py,sha256=SMYCbgXv4sbGi2GEUuMAEWApzr9xG_1295HFgIcnI4A,3799
+tunacode/constants.py,sha256=br_qbqbT1sFcUxA2mpTclUyQn-jsVMr2hrsReyBP8Rc,3799
 tunacode/context.py,sha256=6sterdRvPOyG3LU0nEAXpBsEPZbO3qtPyTlJBi-_VXE,2612
 tunacode/exceptions.py,sha256=_Dyj6cC0868dMABekdQHXCg5XhucJumbGUMXaSDzgB4,2645
 tunacode/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tunacode/setup.py,sha256=dYn0NeAxtNIDSogWEmGSyjb9wsr8AonZ8vAo5sw9NIw,1909
 tunacode/types.py,sha256=BciT-uxnQ44iC-4QiDY72OD23LOtqSyMOuK_N0ttlaA,7676
 tunacode/cli/__init__.py,sha256=zgs0UbAck8hfvhYsWhWOfBe5oK09ug2De1r4RuQZREA,55
-tunacode/cli/commands.py,sha256=VblfttlJsl66pZWy-r3m7grEtHle55jo2wcXI38Anuw,30798
+tunacode/cli/commands.py,sha256=OD3ZnNd5_TjJSAIuDT4rNgruTH_OOuAaR5OAoa8poFQ,34062
 tunacode/cli/main.py,sha256=PIcFnfmIoI_pmK2y-zB_ouJbzR5fbSI7zsKQNPB_J8o,2406
 tunacode/cli/repl.py,sha256=sXtRHYameAlMjlee82ix8P2JjRyWLrdFfHwxfaMKPb8,13722
 tunacode/cli/textual_app.py,sha256=14-Nt0IIETmyHBrNn9uwSF3EwCcutwTp6gdoKgNm0sY,12593
@@ -19,8 +19,8 @@ tunacode/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tunacode/core/state.py,sha256=n1claG-gVVDMBCCS8cDmgas4XbKLJJwKRc-8CtXeTS8,1376
 tunacode/core/tool_handler.py,sha256=OKx7jM8pml6pSEnoARu33_uBY8awJBqvhbVeBn6T4ow,1804
 tunacode/core/agents/__init__.py,sha256=TiXwymGRNMuOqQaRLpNCAt7bZArg8rkadIRs4Nw21SQ,275
-tunacode/core/agents/main.py,sha256=cg6ouw3_nqDeatwI-VP9iay_092MUc59C-fhRZUrOWw,15620
-tunacode/core/agents/orchestrator.py,sha256=IEmhqn2SdiweMzJeQByy29_Rml8nz5cP2n55v_WADUI,4136
+tunacode/core/agents/main.py,sha256=bfm_TS1Z9rpy3phIUb7d1lLbYK99xJwrtBy4PWPSEOE,16673
+tunacode/core/agents/orchestrator.py,sha256=t_eXtCO_QkIz687uT88RpDCmaE0-UkrUaczuTEJOrYQ,4154
 tunacode/core/agents/planner_schema.py,sha256=pu2ehQVALjiJ5HJD7EN6xuZHCknsrXO9z0xHuVdlKW8,345
 tunacode/core/agents/readonly.py,sha256=NOPfqPWu53fJy77k5uqwKWmZ6yzqnDOZpBeQjGy0AG8,1624
 tunacode/core/background/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -53,7 +53,7 @@ tunacode/ui/decorators.py,sha256=e2KM-_pI5EKHa2M045IjUe4rPkTboxaKHXJT0K3461g,191
 tunacode/ui/input.py,sha256=6LlEwKIXYXusNDI2PD0DDjRymQgu5mf2v06TsHbUln0,2957
 tunacode/ui/keybindings.py,sha256=h0MlD73CW_3i2dQzb9EFSPkqy0raZ_isgjxUiA9u6ts,691
 tunacode/ui/lexers.py,sha256=tmg4ic1enyTRLzanN5QPP7D_0n12YjX_8ZhsffzhXA4,1340
-tunacode/ui/output.py,sha256=yDQa_sZW8nernAZrWBb7H_yJtfMPVp7SYpIqxAxF98k,4503
+tunacode/ui/output.py,sha256=wCLvAZb-OeKyLeR7KxD9WSW_GkHk0iX0PDAJilR0Upw,4508
 tunacode/ui/panels.py,sha256=_8B1rGOhPnSLekGM4ZzDJw-dCuaPeacsaCmmCggqxwE,5950
 tunacode/ui/prompt_manager.py,sha256=U2cntB34vm-YwOj3gzFRUK362zccrz8pigQfpxr5sv8,4650
 tunacode/ui/tool_ui.py,sha256=S5-k1HwRlSqiQ8shGQ_QYGXQbuzb6Pg7u3CTqZwffdQ,6533
@@ -67,9 +67,9 @@ tunacode/utils/ripgrep.py,sha256=AXUs2FFt0A7KBV996deS8wreIlUzKOlAHJmwrcAr4No,583
 tunacode/utils/system.py,sha256=FSoibTIH0eybs4oNzbYyufIiV6gb77QaeY2yGqW39AY,11381
 tunacode/utils/text_utils.py,sha256=B9M1cuLTm_SSsr15WNHF6j7WdLWPvWzKZV0Lvfgdbjg,2458
 tunacode/utils/user_configuration.py,sha256=IGvUH37wWtZ4M5xpukZEWYhtuKKyKcl6DaeObGXdleU,2610
-tunacode_cli-0.0.26.dist-info/licenses/LICENSE,sha256=Btzdu2kIoMbdSp6OyCLupB1aRgpTCJ_szMimgEnpkkE,1056
-tunacode_cli-0.0.26.dist-info/METADATA,sha256=BhZektuDc4IMD9T-CtcoNwWeRSWCtm-lnm5lZ9_1TPU,18910
-tunacode_cli-0.0.26.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-tunacode_cli-0.0.26.dist-info/entry_points.txt,sha256=hbkytikj4dGu6rizPuAd_DGUPBGF191RTnhr9wdhORY,51
-tunacode_cli-0.0.26.dist-info/top_level.txt,sha256=lKy2P6BWNi5XSA4DHFvyjQ14V26lDZctwdmhEJrxQbU,9
-tunacode_cli-0.0.26.dist-info/RECORD,,
+tunacode_cli-0.0.28.dist-info/licenses/LICENSE,sha256=Btzdu2kIoMbdSp6OyCLupB1aRgpTCJ_szMimgEnpkkE,1056
+tunacode_cli-0.0.28.dist-info/METADATA,sha256=QAmjxfmzJELeyebnE3H5wCkgGILFP7COYWRcKkl6JFA,3619
+tunacode_cli-0.0.28.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+tunacode_cli-0.0.28.dist-info/entry_points.txt,sha256=hbkytikj4dGu6rizPuAd_DGUPBGF191RTnhr9wdhORY,51
+tunacode_cli-0.0.28.dist-info/top_level.txt,sha256=lKy2P6BWNi5XSA4DHFvyjQ14V26lDZctwdmhEJrxQbU,9
+tunacode_cli-0.0.28.dist-info/RECORD,,

tunacode_cli-0.0.26.dist-info/METADATA

@@ -1,567 +0,0 @@
-Metadata-Version: 2.4
-Name: tunacode-cli
-Version: 0.0.26
-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: typer==0.15.3
-Requires-Dist: prompt_toolkit==3.0.51
-Requires-Dist: pydantic-ai[logfire]==0.2.6
-Requires-Dist: pygments==2.19.1
-Requires-Dist: rich==14.0.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"
-Requires-Dist: textual-dev; extra == "dev"
-Dynamic: license-file
-
-# TunaCode
-
-<div align="center">
-
-[![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)
-
-**Your AI-powered CLI coding assistant**
-
-![Demo](demo.gif)
-
-[Quick Start](#quick-start) • [Features](#features) • [Configuration](#configuration) • [Documentation](#documentation)
-
-</div>
-
----
-
-## Overview
-
-> **⚠️ Safety First**: TunaCode can modify your codebase. Always use git branches before making major changes. The `/undo` command has been removed - use git for version control.
-
-> **Beta Notice**: TunaCode is currently in beta. [Report issues](https://github.com/alchemiststudiosDOTai/tunacode/issues) or share feedback to help us improve!
-
----
-
-### Recent Updates (v0.0.18)
-
-- **Advanced Agent Orchestration**: New orchestrator system for complex multi-step tasks with planning visibility
-- **Background Task Manager**: Asynchronous background processing for long-running operations
-- **Read-Only Agent**: Specialized agent for safe codebase exploration without modification risks
-- **Planning Transparency**: See the AI's planning process before execution with detailed task breakdowns
-- **Shell Command Support**: Execute shell commands directly with `!command` or open interactive shell with `!`
-- **Enhanced Bash Tool**: Advanced bash execution with timeouts, working directory, and environment variables
-- **JSON Tool Parsing Fallback**: Automatic recovery when API providers fail with structured tool calling
-- **Enhanced Reliability**: Fixed parameter naming issues that caused tool schema errors
-- **Configuration Management**: New `/refresh` command to reload config without restart
-- **Improved ReAct Reasoning**: Enhanced iteration limits (now defaults to 20) and better thought processing
-- **New Debug Commands**: `/parsetools` for manual JSON parsing, `/iterations` for controlling reasoning depth
-- **Better Error Recovery**: Multiple fallback mechanisms for various failure scenarios
-
-### Core Features
-
-<table>
-<tr>
-<td width="50%">
-
-### **Multi-Provider Support**
-
-- Anthropic Claude
-- OpenAI GPT  
-- Google Gemini
-- OpenRouter (100+ models)
-- Any OpenAI-compatible API
-
-### **Developer Tools**
-
-- 6 core tools: bash, grep, read_file, write_file, update_file, run_command
-- Direct shell command execution with `!` prefix
-- MCP (Model Context Protocol) support
-- File operation confirmations with diffs
-- Per-project context guides (TUNACODE.md)
-- JSON tool parsing fallback for API compatibility
-
-</td>
-<td width="50%">
-
-### **Safety & Control**
-
-- Git branch integration (`/branch`)
-- No automatic commits
-- Explicit file operation confirmations
-- Permission tracking per session
-- `/yolo` mode for power users
-
-### **Architecture**
-
-- Built on pydantic-ai
-- Async throughout
-- Modular command system
-- Rich UI with syntax highlighting
-- ReAct reasoning patterns
-
-</td>
-</tr>
-</table>
-
----
-
-## Quick Start
-
-### Installation
-
-#### PyPI
-
-```bash
-pip install tunacode-cli
-```
-
-#### Development Installation
-
-```bash
-# Clone the repository
-git clone https://github.com/larock22/tunacode.git
-cd tunacode
-
-# Run the setup script
-./scripts/setup_dev_env.sh
-
-# Or manually:
-python3 -m venv venv
-source venv/bin/activate
-pip install -e ".[dev]"
-```
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed development setup.
-
-#### One-line Install (Linux/macOS)
-
-```bash
-wget -qO- https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
-```
-
-### Uninstallation
-
-To completely remove TunaCode from your system:
-
-```bash
-# Download and run the uninstall script
-wget -qO- https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/uninstall.sh | bash
-
-# Or manually:
-# 1. Remove the package
-pipx uninstall tunacode  # if installed via pipx
-# OR
-pip uninstall tunacode-cli  # if installed via pip
-
-# 2. Remove configuration files
-rm -rf ~/.config/tunacode*
-
-# 3. Remove any leftover binaries
-rm -f ~/.local/bin/tunacode
-```
-
-### Setup Options
-
-<details>
-<summary><b>Option 1: Interactive Setup (Beginner-friendly)</b></summary>
-
-```bash
-tunacode
-```
-
-Follow the interactive prompts to configure your preferred LLM provider.
-
-</details>
-
-<details>
-<summary><b>Option 2: Direct CLI Setup (Recommended)</b></summary>
-
-```bash
-# OpenAI
-tunacode --model "openai:gpt-4.1" --key "your-openai-key"
-
-# Anthropic Claude
-tunacode --model "anthropic:claude-3-opus" --key "your-anthropic-key"
-
-# OpenRouter (Access to multiple models)
-tunacode --baseurl "https://openrouter.ai/api/v1" \
-         --model "openrouter:openai/gpt-4.1" \
-         --key "your-openrouter-key"
-```
-
-</details>
-
-> **Important**: Model names require provider prefixes (e.g., `openai:gpt-4.1`, not `gpt-4.1`)
-
----
-
-## Configuration
-
-### Config Location
-
-Configuration is stored in `~/.config/tunacode.json`
-
-### Model Format
-
-```
-provider:model-name
-```
-
-**Examples:**
-
-- `openai:gpt-4.1`
-- `anthropic:claude-3-opus`
-- `google-gla:gemini-2.0-flash`
-- `openrouter:mistralai/devstral-small`
-
-### OpenRouter Integration
-
-<details>
-<summary><b>Click to expand OpenRouter setup</b></summary>
-
-[OpenRouter](https://openrouter.ai) provides access to 100+ models through a single API:
-
-```bash
-tunacode --baseurl "https://openrouter.ai/api/v1" \
-         --model "openrouter:openai/gpt-4.1" \
-         --key "your-openrouter-key"
-```
-
-**Manual Configuration:**
-
-```json
-{
-  "env": {
-    "OPENROUTER_API_KEY": "<YOUR_KEY>",
-    "OPENAI_BASE_URL": "https://openrouter.ai/api/v1"
-  },
-  "default_model": "openrouter:openai/gpt-4.1"
-}
-```
-
-**Popular Models:**
-
-- `openrouter:mistralai/devstral-small`
-- `openrouter:openai/gpt-4.1-mini`
-- `openrouter:codex-mini-latest`
-
-</details>
-
-### MCP (Model Context Protocol) Support
-
-<details>
-<summary><b>Click to expand MCP configuration</b></summary>
-
-Extend your AI's capabilities with MCP servers:
-
-```json
-{
-  "mcpServers": {
-    "fetch": {
-      "command": "uvx",
-      "args": ["mcp-server-fetch"]
-    },
-    "github": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-github"],
-      "env": {
-        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
-      }
-    }
-  }
-}
-```
-
-Learn more at [modelcontextprotocol.io](https://modelcontextprotocol.io/)
-
-</details>
-
----
-
-## Commands Reference
-
-### Core Commands
-
-| Command                          | Description                      |
-| -------------------------------- | -------------------------------- |
-| `/help`                          | Show available commands          |
-| `/yolo`                          | Toggle confirmation skipping     |
-| `/clear`                         | Clear message history            |
-| `/compact`                       | Summarize and clear old messages |
-| `/model`                         | Show current model               |
-| `/model <provider:name>`         | Switch model                     |
-| `/model <provider:name> default` | Set default model                |
-| `/branch <name>`                 | Create and switch Git branch     |
-| `/dump`                          | Show message history (debug)     |
-| `!<command>`                     | Run shell command                |
-| `!`                              | Open interactive shell           |
-| `exit`                           | Exit application                 |
-
-### Debug & Recovery Commands
-
-| Command                          | Description                      |
-| -------------------------------- | -------------------------------- |
-| `/thoughts`                      | Toggle ReAct thought display     |
-| `/iterations <1-50>`             | Set max reasoning iterations     |
-| `/parsetools`                    | Parse JSON tool calls manually   |
-| `/fix`                           | Fix orphaned tool calls         |
-| `/refresh`                       | Reload configuration from defaults |
-
----
-
-## Available Tools
-
-### Bash Tool
-The enhanced bash tool provides advanced shell command execution with safety features:
-
-- **Working Directory Support**: Execute commands in specific directories
-- **Environment Variables**: Set custom environment variables for commands
-- **Timeout Control**: Configurable timeouts (1-300 seconds) to prevent hanging
-- **Output Capture**: Full stdout/stderr capture with truncation for large outputs
-- **Safety Checks**: Warns about potentially destructive commands
-- **Error Guidance**: Helpful error messages for common issues (command not found, permission denied, etc.)
-
-**Example usage by the AI:**
-```python
-# Simple command
-await bash("ls -la")
-
-# With working directory
-await bash("npm install", cwd="/path/to/project")
-
-# With timeout for long operations
-await bash("npm run build", timeout=120)
-
-# With environment variables
-await bash("python script.py", env={"API_KEY": "secret"})
-```
-
-### Other Core Tools
-- **grep**: Fast parallel content search across files
-- **read_file**: Read file contents with line numbers
-- **write_file**: Create new files (fails if file exists)
-- **update_file**: Modify existing files with precise replacements
-- **run_command**: Basic command execution (simpler than bash)
-
----
-
-## Reliability Features
-
-### JSON Tool Parsing Fallback
-
-TunaCode automatically handles API provider failures with robust JSON parsing:
-
-- **Automatic Recovery**: When structured tool calling fails, TunaCode parses JSON from text responses
-- **Multiple Formats**: Supports inline JSON, code blocks, and complex nested structures
-- **Manual Recovery**: Use `/parsetools` when automatic parsing needs assistance
-- **Visual Feedback**: See `🔧 Recovered using JSON tool parsing` messages during fallback
-
-### Enhanced Error Handling
-
-- **Tool Schema Fixes**: Consistent parameter naming across all tools
-- **Orphaned Tool Call Recovery**: Automatic cleanup with `/fix` command
-- **Configuration Refresh**: Update settings without restart using `/refresh`
-- **ReAct Reasoning**: Configurable iteration limits for complex problem solving
-
----
-
-## Customization
-
-### Project Guides
-
-Create a `TUNACODE.md` file in your project root to customize TunaCode's behavior:
-
-```markdown
-# Project Guide
-
-## Tech Stack
-
-- Python 3.11
-- FastAPI
-- PostgreSQL
-
-## Preferences
-
-- Use type hints
-- Follow PEP 8
-- Write tests for new features
-```
-
----
-
-## Source Code Architecture
-
-### Directory Structure
-
-```
-src/tunacode/
-├── cli/                    # Command Line Interface
-│   ├── commands.py        # Command registry and implementations
-│   ├── main.py           # Entry point and CLI setup (Typer)
-│   └── repl.py           # Interactive REPL loop
-│
-├── configuration/         # Configuration Management
-│   ├── defaults.py       # Default configuration values
-│   ├── models.py         # Configuration data models
-│   └── settings.py       # Settings loader and validator
-│
-├── core/                 # Core Application Logic
-│   ├── agents/           # AI Agent System
-│   │   ├── main.py       # Primary agent implementation (pydantic-ai)
-│   │   ├── orchestrator.py # Complex task orchestration and planning
-│   │   ├── planner_schema.py # Planning data models
-│   │   └── readonly.py   # Read-only agent for safe exploration
-│   ├── background/       # Background Task Management
-│   │   └── manager.py    # Async background task execution
-│   ├── llm/              # LLM Integration
-│   │   └── planner.py    # LLM-based task planning
-│   ├── setup/            # Application Setup & Initialization
-│   │   ├── agent_setup.py     # Agent configuration
-│   │   ├── base.py           # Setup step base class
-│   │   ├── config_setup.py   # Configuration setup
-│   │   ├── coordinator.py    # Setup orchestration
-│   │   ├── environment_setup.py  # Environment validation
-│   │   └── git_safety_setup.py   # Git safety checks
-│   ├── state.py          # Application state management
-│   └── tool_handler.py   # Tool execution and validation
-│
-├── services/             # External Services
-│   └── mcp.py           # Model Context Protocol integration
-│
-├── tools/               # AI Agent Tools
-│   ├── base.py         # Tool base classes
-│   ├── bash.py         # Enhanced shell command execution
-│   ├── grep.py         # Parallel content search tool
-│   ├── read_file.py    # File reading tool
-│   ├── run_command.py  # Basic command execution tool
-│   ├── update_file.py  # File modification tool
-│   └── write_file.py   # File creation tool
-│
-├── ui/                 # User Interface Components
-│   ├── completers.py   # Tab completion
-│   ├── console.py      # Rich console setup
-│   ├── input.py        # Input handling
-│   ├── keybindings.py  # Keyboard shortcuts
-│   ├── lexers.py       # Syntax highlighting
-│   ├── output.py       # Output formatting and banner
-│   ├── panels.py       # UI panels and layouts
-│   ├── prompt_manager.py # Prompt toolkit integration
-│   ├── tool_ui.py      # Tool confirmation dialogs
-│   └── validators.py   # Input validation
-│
-├── utils/              # Utility Functions
-│   ├── bm25.py        # BM25 search algorithm (beta)
-│   ├── diff_utils.py  # Diff generation and formatting
-│   ├── file_utils.py  # File system operations
-│   ├── ripgrep.py     # Code search utilities
-│   ├── system.py      # System information
-│   ├── text_utils.py  # Text processing
-│   └── user_configuration.py # User config management
-│
-├── constants.py        # Application constants
-├── context.py         # Context management
-├── exceptions.py      # Custom exceptions
-├── types.py           # Type definitions
-└── prompts/
-    └── system.md      # System prompts for AI agent
-```
-
-### Key Components
-
-| Component            | Purpose                  | Key Files                       |
-| -------------------- | ------------------------ | ------------------------------- |
-| **CLI Layer**        | Command parsing and REPL | `cli/main.py`, `cli/repl.py`    |
-| **Agent System**     | AI-powered assistance    | `core/agents/main.py`           |
-| **Orchestrator**     | Complex task planning    | `core/agents/orchestrator.py`   |
-| **Background Tasks** | Async task execution     | `core/background/manager.py`    |
-| **Tool System**      | File/command operations  | `tools/*.py`                    |
-| **State Management** | Session state tracking   | `core/state.py`                 |
-| **UI Framework**     | Rich terminal interface  | `ui/output.py`, `ui/console.py` |
-| **Configuration**    | User settings & models   | `configuration/*.py`            |
-| **Setup System**     | Initial configuration    | `core/setup/*.py`               |
-
-### Data Flow
-
-```
-CLI Input → Command Registry → REPL → Agent → Tools → UI Output
-     ↓              ↓           ↓       ↓       ↓        ↑
-State Manager ←────────────────────────────────────────┘
-```
-
----
-
-## Development
-
-### Requirements
-
-- Python 3.10+
-- Git (for version control)
-
-### Development Setup
-
-```bash
-# Install development dependencies
-make install
-
-# Run linting
-make lint
-
-# Run tests
-make test
-```
-
----
-
-## Links
-
-<div align="center">
-
-[![PyPI](https://img.shields.io/badge/PyPI-Package-blue?logo=pypi)](https://pypi.org/project/tunacode-cli/)
-[![GitHub](https://img.shields.io/badge/GitHub-Repository-black?logo=github)](https://github.com/alchemiststudiosDOTai/tunacode)
-[![Issues](https://img.shields.io/badge/GitHub-Issues-red?logo=github)](https://github.com/alchemiststudiosDOTai/tunacode/issues)
-
-</div>
-
----
-
-## License
-
-MIT License - see [LICENSE](LICENSE) file for details.
-
-## Acknowledgments
-
-TunaCode is a fork of [sidekick-cli](https://github.com/geekforbrains/sidekick-cli). Special thanks to the sidekick-cli team for creating the foundation that made TunaCode possible.
-
-### Key Differences from sidekick-cli
-
-While TunaCode builds on the foundation of sidekick-cli, we've made several architectural changes for our workflow:
-
-- **JSON Tool Parsing Fallback**: Added fallback parsing for when API providers fail with structured tool calling
-- **Parallel Search Tools**: New `bash` and `grep` tools with parallel execution for codebase navigation
-- **Agent Orchestration**: Advanced orchestrator for complex multi-step tasks with planning transparency
-- **Background Processing**: Asynchronous task manager for long-running operations
-- **Read-Only Agent**: Safe exploration mode that prevents accidental modifications
-- **ReAct Reasoning**: Implemented ReAct (Reasoning + Acting) patterns with configurable iteration limits
-- **Dynamic Configuration**: Added `/refresh` command and modified configuration management
-- **Safety Changes**: Removed automatic git commits and `/undo` command - requires explicit git usage
-- **Error Recovery**: Multiple fallback mechanisms and orphaned tool call recovery
-- **Tool System Rewrite**: Complete overhaul of internal tools with atomic operations and different confirmation UIs
-- **Debug Commands**: Added `/parsetools`, `/thoughts`, `/iterations` for debugging