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

VT Code is available as an VS Code extension.

The original VTCode extension for Visual Studio Code with full semantic code understanding and AI assistance.

For installation instructions and download links for other IDEs, visit our IDE Downloads page. For troubleshooting, see the IDE Integration Troubleshooting Guide.

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.