Quickstart
Installing and running VT Code
Install globally with Cargo:
cargo install vtcode
Alternatively, with Homebrew:
brew install vinhnx/tap/vtcode
Then simply run vtcode to get started:
vtcode
Available for:
- macOS: Apple Silicon (
aarch64-apple-darwin) and Intel (x86_64-apple-darwin) - Linux: x86_64 and ARM64 architectures
- Windows: x86_64 architecture
Each archive contains the executable - extract and rename to vtcode if needed.
Configuration
Set your API key for your preferred provider:
export GEMINI_API_KEY="your_key_here"
# or
export OPENAI_API_KEY="your_key_here"
# or
export ANTHROPIC_API_KEY="your_key_here"
VT Code supports advanced configuration via vtcode.toml. See Configuration for details.
Core Features
Multi-Provider AI Support
- Gemini, OpenAI, Anthropic, and DeepSeek integration
- Automatic provider selection and failover
- Cost optimization with safety controls
Advanced Code Intelligence
- Tree-sitter parsing for 6+ languages (Rust, Python, JavaScript, TypeScript, Go, Java)
- Semantic code analysis and pattern recognition
- Intelligent refactoring and optimization suggestions
Enterprise Security
- Workspace boundary enforcement
- Configurable command allowlists
- Human-in-the-loop controls for safety
- Comprehensive audit logging
Modular Architecture
- Trait-based tool system for extensibility
- Multi-mode execution (terminal, PTY, streaming)
- Intelligent caching and performance optimization
- Plugin architecture for custom tools
Documentation
- Getting Started - Installation and basic usage
- Configuration - Advanced configuration options
- Architecture - Technical architecture details
- Advanced Features - Safety controls and debug mode
- API Reference - Complete API documentation
- Contributing - Development guidelines
License
This project is licensed under the MIT License - see LICENSE for details.