tunacode-cli 0.0.1__tar.gz

tunacode_cli-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Gavin Vickery
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tunacode_cli-0.0.1/PKG-INFO

@@ -0,0 +1,242 @@
+Metadata-Version: 2.4
+Name: tunacode-cli
+Version: 0.0.1
+Summary: Your agentic CLI developer.
+Author-email: Gavin Vickery <gavin@geekforbrains.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: 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"
+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 (Beta)
+
+[![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/)
+
+![TunaCode Demo](screenshot.gif)
+
+Your agentic CLI developer.
+
+## Overview
+
+TunaCode is an agentic CLI-based AI tool inspired by Claude Code, Copilot, Windsurf and Cursor. It's meant
+to be an open source alternative to these tools, providing a similar experience but with the flexibility of
+using different LLM providers (Anthropic, OpenAI, Google Gemini, OpenRouter) while keeping the agentic workflow.
+
+*TunaCode is currently in beta and under active development. Please [report issues](https://github.com/geekforbrains/tunacode-cli/issues) or share feedback!*
+
+## Features
+
+- No vendor lock-in. Use whichever LLM provider you prefer.
+- MCP support
+- Use /undo when AI breaks things.
+- Easily switch between models in the same session.
+- JIT-style system prompt injection ensures TunaCode doesn't lose the plot.
+- Per-project guide. Adjust TunaCode's behavior to suit your needs.
+- CLI-first design. Ditch the clunky IDE.
+- Cost and token tracking.
+- Per command or per session confirmation skipping.
+
+## Roadmap
+
+- Tests 😅
+- More LLM providers, including OpenRouter and Ollama
+
+## Quick Start
+
+Install TunaCode.
+
+```
+pip install tunacode-cli
+```
+
+On first run, you'll be asked to configure your LLM providers.
+
+```
+tunacode
+```
+
+## Configuration
+
+After initial setup, TunaCode saves a config file to `~/.config/tunacode.json`. You can open and
+edit this file as needed. Future updates will make editing easier directly from within TunaCode.
+
+### OpenRouter Support
+
+To use [OpenRouter](https://openrouter.ai) models, add an `OPENROUTER_API_KEY` to the
+`env` section of your configuration file. TunaCode will set the environment variable so the
+OpenAI client can communicate with OpenRouter:
+
+```json
+{
+  "env": {
+    "OPENROUTER_API_KEY": "<YOUR_KEY>"
+  }
+}
+```
+
+Then run TunaCode with the OpenRouter base URL:
+
+```bash
+OPENAI_BASE_URL="https://openrouter.ai/api/v1" tunacode
+```
+
+You can now switch to OpenRouter models using:
+```
+/model openrouter:mistralai/devstral-small
+```
+
+### MCP Support
+
+TunaCode supports Model Context Protocol (MCP) servers. You can configure MCP servers in your `~/.config/tunacode.json` file:
+
+```json
+{
+  "mcpServers": {
+    "fetch": {
+      "command": "uvx",
+      "args": ["mcp-server-fetch"]
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
+      }
+    }
+  }
+}
+```
+
+MCP servers extend the capabilities of your AI assistant, allowing it to interact with additional tools and data sources. Learn more about MCP at [modelcontextprotocol.io](https://modelcontextprotocol.io/).
+
+### Available Commands
+
+- `/help` - Show available commands
+- `/yolo` - Toggle "yolo" mode (skip tool confirmations)
+- `/clear` - Clear message history
+- `/compact` - Summarize message history and clear old messages
+- `/model` - List available models
+- `/model <num>` - Switch to a specific model (by index)
+- `/branch <name>` - Create and switch to a new Git branch
+- `/undo` - Undo most recent changes
+- `/dump` - Show current message history (for debugging)
+- `exit` - Exit the application
+
+## Customization
+
+TunaCode supports the use of a "guide". This is a `TUNACODE.md` file in the project root that contains
+instructions for TunaCode. Helpful for specifying tech stack, project structure, development
+preferences etc.
+
+## Requirements
+
+- Python 3.10 or higher
+- Git (for undo functionality)
+
+## Installation
+
+### Using pip
+
+```bash
+pip install tunacode-cli
+```
+
+### From Source
+
+1. Clone the repository
+2. Install dependencies: `pip install .` (or `pip install -e .` for development)
+
+## Development
+
+```bash
+# Install development dependencies
+make install
+
+# Run linting
+make lint
+
+# Run tests
+make test
+```
+
+## Release Process
+
+When preparing a new release:
+
+1. Update version numbers in:
+   - `pyproject.toml`
+   - `src/tunacode/constants.py` (APP_VERSION)
+
+2. Commit the version changes:
+   ```bash
+   git add pyproject.toml src/tunacode/constants.py
+   git commit -m "chore: bump version to X.Y.Z"
+   ```
+
+3. Create and push a tag:
+   ```bash
+   git tag vX.Y.Z
+   git push origin vX.Y.Z
+   ```
+
+4. Create a GitHub release:
+   ```bash
+   gh release create vX.Y.Z --title "vX.Y.Z" --notes "Release notes here"
+   ```
+
+5. Merge to main branch and push to trigger PyPI release (automated)
+
+### Commit Convention
+
+This project follows the [Conventional Commits](https://www.conventionalcommits.org/) specification for commit messages:
+
+- `feat:` - New features
+- `fix:` - Bug fixes
+- `docs:` - Documentation changes
+- `style:` - Code style changes (formatting, etc.)
+- `refactor:` - Code refactoring
+- `perf:` - Performance improvements
+- `test:` - Test additions or modifications
+- `chore:` - Maintenance tasks (version bumps, etc.)
+- `build:` - Build system changes
+- `ci:` - CI configuration changes
+
+## Links
+
+- [PyPI Package](https://pypi.org/project/tunacode-cli/)
+- [GitHub Issues](https://github.com/geekforbrains/tunacode-cli/issues)
+- [GitHub Repository](https://github.com/geekforbrains/tunacode-cli)
+
+## License
+
+MIT
+
+## Acknowledgments
+
+This project is a fork of [sidekick-cli](https://github.com/geekforbrains/sidekick-cli). Thank you to the sidekick-cli team for creating the foundation that made TunaCode possible! 🙏

tunacode_cli-0.0.1/README.md

@@ -0,0 +1,207 @@
+# TunaCode (Beta)
+
+[![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/)
+
+![TunaCode Demo](screenshot.gif)
+
+Your agentic CLI developer.
+
+## Overview
+
+TunaCode is an agentic CLI-based AI tool inspired by Claude Code, Copilot, Windsurf and Cursor. It's meant
+to be an open source alternative to these tools, providing a similar experience but with the flexibility of
+using different LLM providers (Anthropic, OpenAI, Google Gemini, OpenRouter) while keeping the agentic workflow.
+
+*TunaCode is currently in beta and under active development. Please [report issues](https://github.com/geekforbrains/tunacode-cli/issues) or share feedback!*
+
+## Features
+
+- No vendor lock-in. Use whichever LLM provider you prefer.
+- MCP support
+- Use /undo when AI breaks things.
+- Easily switch between models in the same session.
+- JIT-style system prompt injection ensures TunaCode doesn't lose the plot.
+- Per-project guide. Adjust TunaCode's behavior to suit your needs.
+- CLI-first design. Ditch the clunky IDE.
+- Cost and token tracking.
+- Per command or per session confirmation skipping.
+
+## Roadmap
+
+- Tests 😅
+- More LLM providers, including OpenRouter and Ollama
+
+## Quick Start
+
+Install TunaCode.
+
+```
+pip install tunacode-cli
+```
+
+On first run, you'll be asked to configure your LLM providers.
+
+```
+tunacode
+```
+
+## Configuration
+
+After initial setup, TunaCode saves a config file to `~/.config/tunacode.json`. You can open and
+edit this file as needed. Future updates will make editing easier directly from within TunaCode.
+
+### OpenRouter Support
+
+To use [OpenRouter](https://openrouter.ai) models, add an `OPENROUTER_API_KEY` to the
+`env` section of your configuration file. TunaCode will set the environment variable so the
+OpenAI client can communicate with OpenRouter:
+
+```json
+{
+  "env": {
+    "OPENROUTER_API_KEY": "<YOUR_KEY>"
+  }
+}
+```
+
+Then run TunaCode with the OpenRouter base URL:
+
+```bash
+OPENAI_BASE_URL="https://openrouter.ai/api/v1" tunacode
+```
+
+You can now switch to OpenRouter models using:
+```
+/model openrouter:mistralai/devstral-small
+```
+
+### MCP Support
+
+TunaCode supports Model Context Protocol (MCP) servers. You can configure MCP servers in your `~/.config/tunacode.json` file:
+
+```json
+{
+  "mcpServers": {
+    "fetch": {
+      "command": "uvx",
+      "args": ["mcp-server-fetch"]
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
+      }
+    }
+  }
+}
+```
+
+MCP servers extend the capabilities of your AI assistant, allowing it to interact with additional tools and data sources. Learn more about MCP at [modelcontextprotocol.io](https://modelcontextprotocol.io/).
+
+### Available Commands
+
+- `/help` - Show available commands
+- `/yolo` - Toggle "yolo" mode (skip tool confirmations)
+- `/clear` - Clear message history
+- `/compact` - Summarize message history and clear old messages
+- `/model` - List available models
+- `/model <num>` - Switch to a specific model (by index)
+- `/branch <name>` - Create and switch to a new Git branch
+- `/undo` - Undo most recent changes
+- `/dump` - Show current message history (for debugging)
+- `exit` - Exit the application
+
+## Customization
+
+TunaCode supports the use of a "guide". This is a `TUNACODE.md` file in the project root that contains
+instructions for TunaCode. Helpful for specifying tech stack, project structure, development
+preferences etc.
+
+## Requirements
+
+- Python 3.10 or higher
+- Git (for undo functionality)
+
+## Installation
+
+### Using pip
+
+```bash
+pip install tunacode-cli
+```
+
+### From Source
+
+1. Clone the repository
+2. Install dependencies: `pip install .` (or `pip install -e .` for development)
+
+## Development
+
+```bash
+# Install development dependencies
+make install
+
+# Run linting
+make lint
+
+# Run tests
+make test
+```
+
+## Release Process
+
+When preparing a new release:
+
+1. Update version numbers in:
+   - `pyproject.toml`
+   - `src/tunacode/constants.py` (APP_VERSION)
+
+2. Commit the version changes:
+   ```bash
+   git add pyproject.toml src/tunacode/constants.py
+   git commit -m "chore: bump version to X.Y.Z"
+   ```
+
+3. Create and push a tag:
+   ```bash
+   git tag vX.Y.Z
+   git push origin vX.Y.Z
+   ```
+
+4. Create a GitHub release:
+   ```bash
+   gh release create vX.Y.Z --title "vX.Y.Z" --notes "Release notes here"
+   ```
+
+5. Merge to main branch and push to trigger PyPI release (automated)
+
+### Commit Convention
+
+This project follows the [Conventional Commits](https://www.conventionalcommits.org/) specification for commit messages:
+
+- `feat:` - New features
+- `fix:` - Bug fixes
+- `docs:` - Documentation changes
+- `style:` - Code style changes (formatting, etc.)
+- `refactor:` - Code refactoring
+- `perf:` - Performance improvements
+- `test:` - Test additions or modifications
+- `chore:` - Maintenance tasks (version bumps, etc.)
+- `build:` - Build system changes
+- `ci:` - CI configuration changes
+
+## Links
+
+- [PyPI Package](https://pypi.org/project/tunacode-cli/)
+- [GitHub Issues](https://github.com/geekforbrains/tunacode-cli/issues)
+- [GitHub Repository](https://github.com/geekforbrains/tunacode-cli)
+
+## License
+
+MIT
+
+## Acknowledgments
+
+This project is a fork of [sidekick-cli](https://github.com/geekforbrains/sidekick-cli). Thank you to the sidekick-cli team for creating the foundation that made TunaCode possible! 🙏

tunacode_cli-0.0.1/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tunacode-cli"
+version = "0.0.1"
+description = "Your agentic CLI developer."
+keywords = ["cli", "agent", "development", "automation"]
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "Gavin Vickery", email = "gavin@geekforbrains.com" },
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "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]
+tunacode = "tunacode.cli.main:app"
+
+[project.optional-dependencies]
+dev = [
+    "build",
+    "black",
+    "flake8",
+    "isort",
+    "pytest",
+    "pytest-cov",
+]
+
+[project.urls]
+Homepage = "https://github.com/larock22/tunacode"
+Repository = "https://github.com/larock22/tunacode"
+
+[tool.black]
+line-length = 100
+
+[tool.isort]
+line_length = 100

tunacode_cli-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tunacode_cli-0.0.1/setup.py

@@ -0,0 +1,10 @@
+from setuptools import setup, find_namespace_packages
+
+setup(
+    package_dir={"": "src"},
+    packages=find_namespace_packages(where="src"),
+    include_package_data=True,
+    package_data={
+        "tunacode": ["prompts/*.txt"],
+    },
+)

tunacode_cli-0.0.1/src/tunacode/cli/__init__.py

@@ -0,0 +1,4 @@
+# CLI package
+from .main import app
+
+__all__ = ["app"]