A TUI code agent.

Note: Under active development - expect bugs.

The Textual-based terminal user interface provides a clean, interactive environment for AI-assisted coding, with a design heavily inspired by the classic NeXTSTEP user interface.

The interface supports multiple themes for different preferences and environments.

Customize the appearance with built-in themes or create your own color schemes.

Configure your AI models and settings through the provided setup interface.

Note: TunaCode has full bash shell access. This tool assumes you know what you're doing. If you're concerned, run it in a sandboxed environment.

This release is a complete rewrite with a new Textual-based TUI.

Upgrading from v1? The legacy v1 codebase is preserved in the legacy-v1 branch and will only receive security updates.

• Python 3.11+

uv tool install tunacode-cli

1. Run the setup wizard to configure your API key:

tunacode --setup

2. Start coding:

tunacode

Set your API key as an environment variable or use the setup wizard:

export OPENAI_API_KEY="your-key"
# or
export ANTHROPIC_API_KEY="your-key"

Config file location: ~/.config/tunacode.json

TunaCode includes experimental Language Server Protocol support for real-time diagnostics. When an LSP server is detected in your PATH, it activates automatically.

Supported languages:

Diagnostics appear in the UI when editing files. This feature is beta - expect rough edges.

Join our official discord server to receive help, show us how you're using tunacode, and chat about anything LLM.

MIT