Built With

• tinyAgent - Core agent loop handling LLM interaction and tool execution
• alchemy-rs - Rust-powered tokenizer and utilities via PyO3 bindings
• Textual - Terminal UI framework with CSS-based styling
• Rich - Terminal rendering with syntax highlighting
• Typer - CLI framework

Migration Notes

Recent Breaking Changes:

• Session persistence format changed - existing sessions may not load correctly
• Tool execution runs in parallel batches with a strict cap of 3 in-flight tool calls
• The docs/ directory has been restructured

For full details, see the CHANGELOG.

Installation

End Users

uv tool install tunacode-cli

Or with pip:

pip install tunacode-cli

Developers (Fresh Clone)

git clone https://github.com/alchemiststudiosDOTai/tunacode.git
cd tunacode
make dev-setup

Or without make:

git clone https://github.com/alchemiststudiosDOTai/tunacode.git
cd tunacode
./scripts/dev-setup.sh

Development

Common development tasks:

make dev-setup  # Full setup for fresh clone
make install    # Install/update dependencies
make run        # Run the development server
make test       # Run test suite
make lint       # Run linters
make clean      # Clean build artifacts

View technical debt:

uv run python scripts/todo_scan...