cargo install vtcode
or brew install vinhnx/tap/vtcode
or npm install -g vtcode-ai

VT Code is a Rust-based terminal coding agent with semantic code intelligence via Tree-sitter and ast-grep.

Supports multiple LLM providers with automatic failover and efficient context management.

Install globally with your preferred package manager. If you use Cargo:

cargo install vtcode

Alternatively, if you use Homebrew:

brew install vinhnx/tap/vtcode

Or if you prefer NPM:

npm install -g vtcode

Then simply run vtcode to get started:

vtcode

Set your API key environment variable and run VT Code:

# Set your API key
export OPENAI_API_KEY="your_api_key_here"

# Launch VT Code
vtcode

VT Code supports multiple providers including OpenAI, Anthropic, xAI, DeepSeek, Gemini, Z.AI, Moonshot AI, OpenRouter, and Ollama (local).

Set your preferred API key environment variable:

export OPENAI_API_KEY="sk-..."           # OpenAI
export ANTHROPIC_API_KEY="sk-ant-..."    # Anthropic
export GEMINI_API_KEY="AIza..."          # Google Gemini
export XAI_API_KEY="xai-..."             # xAI
export DEEPSEEK_API_KEY="sk-..."         # DeepSeek
export ZAI_API_KEY="zai-..."             # Z.AI
export MOONSHOT_API_KEY="sk-..."         # Moonshot AI
export OPENROUTER_API_KEY="sk-or-..."    # OpenRouter

VT Code can integrate with code editors like Zed. To configure ACP, refer to the ACP docs.

VT Code supports a rich set of configuration options, with preferences stored in vtcode.toml. For full configuration options, see Configuration.

• Security First: Multi-layered security model with execution policy, sandbox integration, and argument injection protection
• Multi-Provider AI: OpenAI, Anthropic, xAI, DeepSeek, Gemini, Z.AI, Moonshot AI, OpenRouter, Ollama (local)
• Code Intelligence: Tree-sitter parsers for Rust, Python, JavaScript/TypeScript, Go, Java, Swift
• Smart Tools: Built-in code analysis, file operations, terminal commands, and refactoring
• Editor Integration: Native support for Zed IDE via Agent Client Protocol (ACP)
• Semantic Search: AST-based search capabilities with ast-grep integration
• Context Management: Advanced token budget tracking and context curation
• TUI Interface: Rich terminal user interface with real-time streaming

VT Code implements a defense-in-depth security model to protect against prompt injection and argument injection attacks:

• Execution Policy: Command allowlist with per-command argument validation
• Workspace Isolation: All operations confined to workspace boundaries
• Sandbox Integration: Optional Anthropic sandbox runtime for network commands
• Human-in-the-Loop: Configurable approval system for sensitive operations
• Audit Trail: Comprehensive logging of all command executions

See Security Model for details.

• Getting started
  • Interactive mode
  • Command line interface
  • Custom prompts
  • Configuration
• Context Engineering
  • Token budget management
  • Dynamic context curation
• Code Intelligence
  • AST-Grep tools
  • Semantic search
• Agent Client Protocol (ACP)
• Zed Integration
• Custom Prompts
• Exec Mode
• Development
  • Testing
  • CI/CD
• Architecture
• Security
  • Security Model
  • Security Audit
  • Tool Policies

I build VT Code in my free time as a passion project to research and explore how coding agents work in practice. If you find VT Code useful, please consider supporting my work with a coffee via BuyMeACoffee:

Your support means the world to me, thank you!

This repository is licensed under the MIT License.