# VT Code
**VT Code** is an AI coding assistant available for your favorite IDEs. This repository contains the Visual Studio Code extension, providing deep integration with [VT Code](https://github.com/vinhnx/vtcode), a Rust-based terminal coding agent with semantic code intelligence.
## Download VT Code Extension for your IDE
For installation instructions and download links for other IDEs, visit our [IDE Downloads](./docs/ide-downloads.md) page.
## Features
- **AI Coding Assistant**: Access the VT Code agent directly from VS Code
- **Quick Actions**: Easily send questions and get responses without leaving your editor
- **Code Analysis**: Analyze your workspace with semantic code intelligence
- **Configuration Management**: Edit your `vtcode.toml` configuration files with syntax highlighting
- **Context Awareness**: Leverages Tree-sitter for deep code understanding with enhanced regex search
- **Multi-Provider AI**: Supports OpenAI, Anthropic, Google, xAI, DeepSeek, and more
- **Security First**: Built-in safeguards with human-in-the-loop controls
## Prerequisites
Before using this extension, you need to have the VT Code CLI installed:
```bash
# Install with Cargo (recommended)
cargo install vtcode
# Or with Homebrew
brew install vtcode
# Or with NPM
npm install -g vtcode-ai
```
## Quick Start
1. Install the VT Code CLI using one of the methods above
2. Install this extension from the VS Code Marketplace
3. Open a workspace containing a `vtcode.toml` file
4. Access VT Code features through:
- The Command Palette (`Cmd+Shift+P` or `Ctrl+Shift+P`)
- The VT Code Quick Actions view in the Explorer
- Right-click context menu on selected code
- Status bar icon
## Commands
The extension contributes the following commands:
- `VT Code: Open Quick Actions` - Access the quick actions panel
- `VT Code: Ask the Agent` - Send a question to the VT Code agent
- `VT Code: Ask About Selection` - Ask about highlighted code
- `VT Code: Launch Agent Terminal` - Open an integrated terminal session running `vtcode chat`
- `VT Code: Analyze Workspace` - Run `vtcode analyze` on your workspace
- `VT Code: Open Configuration` - Edit your `vtcode.toml` configuration file
- `VT Code: Open Documentation` - Access VT Code documentation
- `VT Code: Toggle Human-in-the-Loop` - Control human approval for sensitive operations
- And more...
## Configuration
The extension contributes the following settings:
- `vtcode.commandPath`: Path to the VT Code executable (default: `vtcode`)
For comprehensive VT Code configuration options, see the [configuration documentation](./docs/config.md). You can also use the example configuration files provided:
- [vtcode.toml](./vtcode.toml) - Basic configuration example
- [vtcode.toml.example](./vtcode.toml.example) - Comprehensive configuration with all options
## Requirements
- VS Code version 1.87.0 or higher
- VT Code now supports placing the VT Code view container in VS Code's Secondary Side Bar (VS Code 1.106+). You can move the VT Code container from the activity bar to the secondary side bar via drag-and-drop or through the context menus in the UI.
- VT Code CLI installed and accessible in your PATH
## Contributing
Contributions are welcome! Please see the [main VT Code repository](https://github.com/vinhnx/vtcode) for contribution guidelines.
### Development
For development instructions, see [DEVELOPMENT.md](DEVELOPMENT.md).
### Releasing
To release a new version of the extension:
```bash
# Patch release (0.1.1 -> 0.1.2)
./release.sh patch
# Minor release (0.1.1 -> 0.2.0)
./release.sh minor
# Major release (0.1.1 -> 1.0.0)
./release.sh major
```
The release script automates version bumping, building, packaging, and publishing to both VSCode Marketplace and Open VSX Registry. See [RELEASE.md](RELEASE.md) for details.
## Support
If you find VT Code useful, please consider supporting the project by visiting [BuyMeACoffee](https://www.buymeacoffee.com/vinhnx).
## License
This extension is licensed under the [MIT License](LICENSE).