tunacode-cli 0.0.10__tar.gz → 0.0.12__tar.gz

{tunacode_cli-0.0.10 → tunacode_cli-0.0.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tunacode-cli
-Version: 0.0.10
+Version: 0.0.12
 Summary: Your agentic CLI developer.
 Author-email: larock22 <noreply@github.com>
 License-Expression: MIT
@@ -19,11 +19,11 @@ 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
-Requires-Dist: typer==0.15.3
 Provides-Extra: dev
 Requires-Dist: build; extra == "dev"
 Requires-Dist: black; extra == "dev"
@@ -31,6 +31,7 @@ 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
@@ -126,6 +127,27 @@ pip install tunacode-cli
 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>
@@ -285,6 +307,97 @@ Create a `TUNACODE.md` file your project root to customize TunaCode's behavior:
 
 ---
 
+## 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)
+│   ├── 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
+│   └── undo_service.py  # Undo operations (beta)
+│
+├── tools/               # AI Agent Tools
+│   ├── base.py         # Tool base classes
+│   ├── read_file.py    # File reading tool
+│   ├── run_command.py  # 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.txt     # 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`           |
+| **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
@@ -305,44 +418,6 @@ make lint
 make test
 ```
 
-### Release Process
-
-<details>
-<summary><b>Click to expand release steps</b></summary>
-
-1. **Update versions:**
-
-   - `pyproject.toml`
-   - `src/tunacode/constants.py` (APP_VERSION)
-
-2. **Commit and tag:**
-
-   ```bash
-   git add pyproject.toml src/tunacode/constants.py
-   git commit -m "chore: bump version to X.Y.Z"
-   git tag vX.Y.Z
-   git push origin vX.Y.Z
-   ```
-
-3. **Create release:**
-   ```bash
-   gh release create vX.Y.Z --title "vX.Y.Z" --notes "Release notes"
-   ```
-
-</details>
-
-### Commit Convention
-
-Following [Conventional Commits](https://www.conventionalcommits.org/):
-
-- `feat:` New features
-- `fix:` Bug fixes
-- `docs:` Documentation
-- `style:` Code formatting
-- `refactor:` Code refactoring
-- `test:` Tests
-- `chore:` Maintenance
-
 ---
 
 ## Links

{tunacode_cli-0.0.10 → tunacode_cli-0.0.12}/README.md

@@ -91,6 +91,27 @@ pip install tunacode-cli
 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>
@@ -250,6 +271,97 @@ Create a `TUNACODE.md` file your project root to customize TunaCode's behavior:
 
 ---
 
+## 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)
+│   ├── 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
+│   └── undo_service.py  # Undo operations (beta)
+│
+├── tools/               # AI Agent Tools
+│   ├── base.py         # Tool base classes
+│   ├── read_file.py    # File reading tool
+│   ├── run_command.py  # 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.txt     # 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`           |
+| **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
@@ -270,44 +382,6 @@ make lint
 make test
 ```
 
-### Release Process
-
-<details>
-<summary><b>Click to expand release steps</b></summary>
-
-1. **Update versions:**
-
-   - `pyproject.toml`
-   - `src/tunacode/constants.py` (APP_VERSION)
-
-2. **Commit and tag:**
-
-   ```bash
-   git add pyproject.toml src/tunacode/constants.py
-   git commit -m "chore: bump version to X.Y.Z"
-   git tag vX.Y.Z
-   git push origin vX.Y.Z
-   ```
-
-3. **Create release:**
-   ```bash
-   gh release create vX.Y.Z --title "vX.Y.Z" --notes "Release notes"
-   ```
-
-</details>
-
-### Commit Convention
-
-Following [Conventional Commits](https://www.conventionalcommits.org/):
-
-- `feat:` New features
-- `fix:` Bug fixes
-- `docs:` Documentation
-- `style:` Code formatting
-- `refactor:` Code refactoring
-- `test:` Tests
-- `chore:` Maintenance
-
 ---
 
 ## Links

{tunacode_cli-0.0.10 → tunacode_cli-0.0.12}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tunacode-cli"
-version = "0.0.10"
+version = "0.0.12"
 description = "Your agentic CLI developer."
 keywords = ["cli", "agent", "development", "automation"]
 readme = "README.md"
@@ -25,11 +25,11 @@ classifiers = [
     "Topic :: Utilities",
 ]
 dependencies = [
+    "typer==0.15.3",
     "prompt_toolkit==3.0.51",
     "pydantic-ai[logfire]==0.2.6",
     "pygments==2.19.1",
     "rich==14.0.0",
-    "typer==0.15.3",
 ]
 
 [project.scripts]
@@ -38,11 +38,12 @@ tunacode = "tunacode.cli.main:app"
 [project.optional-dependencies]
 dev = [
     "build",
-    "black",
+    "black", 
     "flake8",
     "isort",
     "pytest",
     "pytest-cov",
+    "textual-dev",
 ]
 
 [project.urls]

{tunacode_cli-0.0.10 → tunacode_cli-0.0.12}/src/tunacode/cli/commands.py

@@ -1,4 +1,4 @@
-"""Command system for Sidekick CLI."""
+"""Command system for TunaCode CLI."""
 
 from abc import ABC, abstractmethod
 from dataclasses import dataclass
@@ -248,14 +248,13 @@ class BranchCommand(SimpleCommand):
 
     async def execute(self, args: List[str], context: CommandContext) -> None:
         import subprocess
-
-        from ..services.undo_service import is_in_git_project
+        import os
 
         if not args:
             await ui.error("Usage: /branch <branch-name>")
             return
 
-        if not is_in_git_project():
+        if not os.path.exists(".git"):
             await ui.error("Not a git repository")
             return
 

{tunacode_cli-0.0.10 → tunacode_cli-0.0.12}/src/tunacode/cli/main.py

@@ -1,8 +1,7 @@
 """
-Module: sidekick.cli.main
+Module: tunacode.cli.main
 
-CLI entry point and main command handling for the Sidekick application.
-Manages application startup, version checking, and REPL initialization.
+Enhanced CLI entry point with better styling while staying CLI-based.
 """
 
 import asyncio
@@ -17,7 +16,7 @@ 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)
+app = typer.Typer(help="🐟 TunaCode - Your AI-powered development assistant")
 state_manager = StateManager()
 
 
@@ -29,6 +28,8 @@ def main(
     model: str = typer.Option(None, "--model", help="Default model to use (e.g., openai/gpt-4)"),
     key: str = typer.Option(None, "--key", help="API key for the provider"),
 ):
+    """🚀 Start TunaCode - Your AI-powered development assistant"""
+    
     if version:
         asyncio.run(ui.version())
         return

{tunacode_cli-0.0.10 → tunacode_cli-0.0.12}/src/tunacode/cli/repl.py

@@ -1,7 +1,7 @@
 """
-Module: sidekick.cli.repl
+Module: tunacode.cli.repl
 
-Interactive REPL (Read-Eval-Print Loop) implementation for Sidekick.
+Interactive REPL (Read-Eval-Print Loop) implementation for TunaCode.
 Handles user input, command processing, and agent interaction in an interactive shell.
 """
 
@@ -207,18 +207,7 @@ async def repl(state_manager: StateManager):
     action = None
 
     # Professional startup information
-    await ui.info("TunaCode v0.1 - Beta Release")
-    await ui.muted("• Caution: This tool can modify your codebase")
     await ui.muted(f"• Model: {state_manager.session.current_model}")
-    await ui.line()
-    
-    # Important safety warning
-    await ui.warning("⚠️  IMPORTANT: The /undo command has been removed for safety reasons")
-    await ui.muted("• Always use git branches before making major changes")
-    await ui.muted("• Use '/branch <name>' to create a new branch for experiments")
-    await ui.muted("• Commit your work frequently to preserve changes")
-    await ui.line()
-    
     await ui.success("Ready to assist with your development")
     await ui.line()