VTCode - Terminal Coding Agent

A Rust-based terminal coding agent with modular architecture supporting multiple LLM providers (Gemini, OpenAI, Anthropic, DeepSeek) and tree-sitter parsers for 6+ languages.

🚀 Quick Start

1. Install

Cargo (Recommended):

cargo install vtcode

Homebrew (macOS):

brew install vinhnx/tap/vtcode

Pre-built Binaries: Download from GitHub Releases

2. Configure API Key

# Set your API key (choose one)
export GEMINI_API_KEY="your_gemini_key"
export OPENAI_API_KEY="your_openai_key"
export ANTHROPIC_API_KEY="your_anthropic_key"
export DEEPSEEK_API_KEY="your_deepseek_key"

3. Run

# Initialize in your project
vtcode init

# Start interactive chat
vtcode chat

# Or run with custom workspace
vtcode --workspace-dir /path/to/project chat

📋 Requirements

• Rust 1.75+ (for building from source)
• API Key from one of: Gemini, OpenAI, Anthropic, or DeepSeek

⚙️ Configuration

VTCode uses vtcode.toml for configuration. Key settings:

[agent]
provider = "gemini"  # or "openai", "anthropic", "deepseek"
default_model = "gemini-2.5-flash-lite-preview-06-17"
max_conversation_turns = 150

[security]
human_in_the_loop = true  # Require confirmation for destructive actions

🎯 Key Features

• Multi-Provider LLM Support - Gemini, OpenAI, Anthropic, DeepSeek
• Advanced Code Analysis - Tree-sitter parsers for Rust, Python, JavaScript, TypeScript, Go, Java
• Intelligent Tool Suite - File operations, search, terminal commands, PTY integration
• Workspace Safety - Path validation and configurable security policies
• Context Engineering - Full conversation history with intelligent management
• Decision Ledger - Structured record of agent decisions for consistency

📚 Documentation

• API Docs: docs.rs/vtcode
• User Guide: docs/
• Configuration: docs/project/

🛠️ Development

# Clone repository
git clone https://github.com/vinhnx/vtcode.git
cd vtcode

# Build and run
./run.sh              # Production build
./run-debug.sh        # Development build

# Run tests
cargo test

# Check code quality
cargo clippy
cargo fmt

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

📄 License

MIT License - see LICENSE for details.