# 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
Choose your AI provider and set your API key:
# 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
(edit directly with nvim ~/.config/tunacode.json
)
Based on extensive testing, these models provide the best performance:
google/gemini-2.5-pro
- Excellent for complex reasoningopenai/gpt-4.1
- Strong general-purpose modeldeepseek/deepseek-r1-0528
- Great for code generationopenai/gpt-4.1-mini
- Fast and cost-effectiveanthropic/claude-4-sonnet-20250522
- Superior context handling
Note: Formal evaluations coming soon. Any model can work, but these have shown the best results in practice.
tunacode
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 |
TunaCode leverages parallel execution for read-only operations, achieving 3x faster file operations:
Multiple file reads, directory listings, and searches execute concurrently using async I/O, making code exploration significantly faster.
- Streaming UI: Currently working on implementing streaming responses for better user experience
- Bug Fixes: Actively addressing issues - please report any bugs you encounter!
Note: While the tool is fully functional, we're focusing on stability and core features before optimizing for speed.
- Use Git branches before making changes
- Review file modifications before confirming
- Keep backups of important work
- Features - All features, tools, and commands
- Advanced Configuration - Provider setup, MCP, customization
- Architecture - Source code organization and design
- Development - Contributing and development setup
MIT License - see LICENSE file