tunacode-cli 0.0.1__py3-none-any.whl

tunacode_cli-0.0.1.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,65 @@
+tunacode/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tunacode/constants.py,sha256=SOy0DyXaIHHReGbmkelLkXFxOp3vXtM8wQRTKUE8EKA,4249
+tunacode/context.py,sha256=0ttsxxLAyD4pSoxw7S-pyzor0JUkhOFZh96aAf4Kqsg,2634
+tunacode/exceptions.py,sha256=MtXigF5Y0n-C2iZAMJVHQU7DcJ4HQQzmxjsQyc4sCfE,2647
+tunacode/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tunacode/setup.py,sha256=KCNhnu8FY5bFRqR0JMIh22xVakCC97kchmyGsUGUaJ4,1811
+tunacode/types.py,sha256=-qFH7U3eqYvXqpeTU_TAIGIlrOWYBfm-qeH4AeH3GHs,7146
+tunacode/cli/__init__.py,sha256=zgs0UbAck8hfvhYsWhWOfBe5oK09ug2De1r4RuQZREA,55
+tunacode/cli/commands.py,sha256=911tz2e13ljTVlY5DR44qt8aeyTQo4dF4H9BoziRMtA,20732
+tunacode/cli/main.py,sha256=5_CXYtzN-Mc3nOv2Xpk6yfnV4d2SOgA9ENyTCe0cYYw,1226
+tunacode/cli/repl.py,sha256=7g2c5M10bMsSmsomTIiR8bPlUAaqp83hybuVZdwT5kM,8789
+tunacode/configuration/__init__.py,sha256=MbVXy8bGu0yKehzgdgZ_mfWlYGvIdb1dY2Ly75nfuPE,17
+tunacode/configuration/defaults.py,sha256=9fR_Wydc85fU5LN5LlgRfW6geZNPNFMqKRVLN2v_TQ8,694
+tunacode/configuration/models.py,sha256=sOW_pb3HeWdmoZ5SbHsogUDFhiIZZ1GstM18KTr_G8k,2883
+tunacode/configuration/settings.py,sha256=0HqwEFkpGqPtF-h0sAIBHFXTlJQ_KtelD_s-z2XDSak,992
+tunacode/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tunacode/core/state.py,sha256=0U_WU92yn5EQ27BLlHIkNIJJqjLMNHKNYSoba1rQqbQ,1376
+tunacode/core/tool_handler.py,sha256=OKx7jM8pml6pSEnoARu33_uBY8awJBqvhbVeBn6T4ow,1804
+tunacode/core/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tunacode/core/agents/main.py,sha256=ZGB-EUQ7ow-m3ohSAmfPZ5UN9XC2Gbz40rKjsZsWwrA,4669
+tunacode/core/setup/__init__.py,sha256=jlveyriTXRcnoBLU6_TJ7Z-3E6EXjT9L5GD1vW4dei0,427
+tunacode/core/setup/agent_setup.py,sha256=k1bmQ21ue17_zZsWlhIfc7ZWN6vZtmOgKMMzR4Xu9-k,1410
+tunacode/core/setup/base.py,sha256=x9uYOITulrf4faP70NPTNBPb-wW1ZJGmcjAe0Sk5slk,961
+tunacode/core/setup/config_setup.py,sha256=1eDS8iIG9z_BvrmeL8d9QUEBtPXSjOcrNu-2vHtvSFk,7474
+tunacode/core/setup/coordinator.py,sha256=pT1mI24Kllo2H6Hjb-uULLsA1E3X3BqQB7nSGe70SRw,1598
+tunacode/core/setup/environment_setup.py,sha256=u6Anb9uDicmdMA_9xLkP0j2uoiVY16ojsA7XnFz--yQ,2234
+tunacode/core/setup/git_safety_setup.py,sha256=1NuzSASi0b69wQRpcOgINKklGnq34Xh3itm_PEpjDus,7238
+tunacode/core/setup/undo_setup.py,sha256=BUVbEKFQ_Edgbyp5zJziWdaog4tXgl-S98n0mSOzumA,1119
+tunacode/prompts/system.txt,sha256=kaXIoQQQmdau7j2cD4MbF47KhfJZhV6zrfi2boJ4b3s,3225
+tunacode/services/__init__.py,sha256=w_E8QK6RnvKSvU866eDe8BCRV26rAm4d3R-Yg06OWCU,19
+tunacode/services/mcp.py,sha256=R48X73KQjQ9vwhBrtbWHSBl-4K99QXmbIhh5J_1Gezo,3046
+tunacode/services/undo_service.py,sha256=LWhcLY12FdKXI9jd85pizxDOuZ2AHVyA1BRx4UWiiOc,7748
+tunacode/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tunacode/tools/base.py,sha256=5IXKgiHVnV7pPgWTiT0mhFLy2dA2vuryy8Ri_CHsZBY,8936
+tunacode/tools/read_file.py,sha256=QW97pPVcHvNJk48iPSwzOZ9Dbq_Ce8lQ7W0F82SXi7k,3051
+tunacode/tools/run_command.py,sha256=dspFV71g98gbOQV6CT9LsEoytQ_4zyVqqZD99zf__OY,3796
+tunacode/tools/update_file.py,sha256=oG7ELWX3uHboDs2BPy8hfZb6hh0bQOav-LlWIRynMO4,4145
+tunacode/tools/write_file.py,sha256=bV-Xz_Wy_SaCqU78PcxP2ttScfH7F7GGnvs4P7EDuAM,2821
+tunacode/ui/__init__.py,sha256=aRNE2pS50nFAX6y--rSGMNYwhz905g14gRd6g4BolYU,13
+tunacode/ui/completers.py,sha256=A35gtImDcZt_kg7dIFsGL1CGnKmfEt9UJXYh4ZvQebg,5069
+tunacode/ui/console.py,sha256=7ua1LaBP3ZCRHzV0SqVCkgNlgBuBcBTcvybRjWl5jew,1943
+tunacode/ui/constants.py,sha256=NxegAWaoDaEa4gzNZ7p67M0ZsHJJxZMtf2bW8E5WeZE,421
+tunacode/ui/decorators.py,sha256=I09tETtxPfcWdh1B3kEM0nJ8E6HvdBZAdYhRzYUa_p8,1901
+tunacode/ui/input.py,sha256=SmgwwJ4Ge1QQWk9hyu3gG1qke_aLRtyodOQGk7EThQ0,2956
+tunacode/ui/keybindings.py,sha256=uT23EYLLoso-b4ppN-RqbdYOYanGqMr5FKm8OphhhFs,701
+tunacode/ui/lexers.py,sha256=3qFwogyS_3zlS0NDxbc4e_sPvNHylNdCVMjPIIp85go,1507
+tunacode/ui/output.py,sha256=jBsVXLLdMeI1Cr8XxI5o-XdXUXMR17gZncl0Iq5T8Ug,3811
+tunacode/ui/panels.py,sha256=gsTDPX68LRcSxAlzCB01R3dfLT5sNWgSeoB-nCxeSmM,5933
+tunacode/ui/prompt_manager.py,sha256=i8LBDFalo72b9YP1-65X0v0DA62k-auSVEJMXXr31fs,4010
+tunacode/ui/tool_ui.py,sha256=XqJhVm3NNGwvIbMYQ8JmmLwjGeIT3WHCf5INrgBfpY8,6530
+tunacode/ui/validators.py,sha256=wkg-lQrP-Wjm5phUHKD3Mte8F1J3A2EjESQgPPtRcvQ,758
+tunacode/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tunacode/utils/bm25.py,sha256=yq7KFWP3g_zIsjUV7l2hFPXYCzXyNQUInLU7u4qsc_4,1909
+tunacode/utils/diff_utils.py,sha256=V9PM1Of0wvWNTVyw7iZYrNowFuRiKSyWiw5F39yRRYA,2394
+tunacode/utils/file_utils.py,sha256=AXiAJ_idtlmXEi9pMvwtfPy9Ys3yK-F4K7qb_NpwonU,923
+tunacode/utils/ripgrep.py,sha256=AXUs2FFt0A7KBV996deS8wreIlUzKOlAHJmwrcAr4No,583
+tunacode/utils/system.py,sha256=Do-YKMrpTcp49DtnacisOj-NqnM8clI1YJeD6ebRUpw,11381
+tunacode/utils/text_utils.py,sha256=B9M1cuLTm_SSsr15WNHF6j7WdLWPvWzKZV0Lvfgdbjg,2458
+tunacode/utils/user_configuration.py,sha256=uFrpSRTUf0CijZjw1rOp1sovqy1uyr0UNcn85S6jvdk,1790
+tunacode_cli-0.0.1.dist-info/licenses/LICENSE,sha256=SgvEceNP-y3_WodntkMGAkZyl_hAUvzBw5T9W--7YpM,1070
+tunacode_cli-0.0.1.dist-info/METADATA,sha256=S-RIcXtow9xKWGZEvRbsscv3qTxp0Gr7LdL40OlUrOs,6787
+tunacode_cli-0.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+tunacode_cli-0.0.1.dist-info/entry_points.txt,sha256=hbkytikj4dGu6rizPuAd_DGUPBGF191RTnhr9wdhORY,51
+tunacode_cli-0.0.1.dist-info/top_level.txt,sha256=lKy2P6BWNi5XSA4DHFvyjQ14V26lDZctwdmhEJrxQbU,9
+tunacode_cli-0.0.1.dist-info/RECORD,,

tunacode_cli-0.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

tunacode_cli-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tunacode = tunacode.cli.main:app

tunacode_cli-0.0.1.dist-info/licenses/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.dist-info/top_level.txt

@@ -0,0 +1 @@
+tunacode