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

tunacode_cli-0.0.7/PKG-INFO

@@ -0,0 +1,262 @@
+Metadata-Version: 2.4
+Name: tunacode-cli
+Version: 0.0.7
+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
+
+### 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
+```
+
+## 📋 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` |
+| `--update` | Update to latest version | `tunacode --update` |
+
+## 🔧 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.7/README.md

@@ -0,0 +1,226 @@
+# 🐟 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
+
+### 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
+```
+
+## 📋 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` |
+| `--update` | Update to latest version | `tunacode --update` |
+
+## 🔧 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.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tunacode-cli"
-version = "0.0.5"
+version = "0.0.7"
 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]