Skip to content

mohaidoss/tunacode

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

TunaCode

PyPI version Downloads Python 3.10+ License: MIT

AI-powered CLI coding assistant

TunaCode Example


Quick Install

# 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

Configuration

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)

Recommended Models

Based on extensive testing, these models provide the best performance:

  • google/gemini-2.5-pro - Excellent for complex reasoning
  • openai/gpt-4.1 - Strong general-purpose model
  • deepseek/deepseek-r1-0528 - Great for code generation
  • openai/gpt-4.1-mini - Fast and cost-effective
  • anthropic/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.

Start Coding

tunacode

Basic Commands

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

Performance

TunaCode leverages parallel execution for read-only operations, achieving 3x faster file operations:

Parallel Execution Performance

Multiple file reads, directory listings, and searches execute concurrently using async I/O, making code exploration significantly faster.

Features in Development

  • 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.

Safety First

โš ๏ธ Important: TunaCode can modify your codebase. Always:

  • Use Git branches before making changes
  • Review file modifications before confirming
  • Keep backups of important work

Documentation

Links


MIT License - see LICENSE file

About

๐ŸŸ TunaCode AI CLI coding agent with safe git branches, rich tools & multi-LLM support.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 93.8%
  • Shell 6.0%
  • Makefile 0.2%