VTCode is an open-source terminal-based AI coding agent built in Rust by Vinh Nguyen (vinhnx). Engineered as a high-performance CLI tool, it allows developers to interact with AI models directly from the command line to inspect codebases, execute refactorings, run bounded code searches, and automate developer workflows. In day-to-day use, VTCode operates in the terminal environment, executing multi-step coding operations through structured tool calls and search contracts. It interacts with local repository files, handles patches, manages search replay invalidation, and applies workspace linting while executing tasks within strict provider boundaries. VTCode distinguishes itself through its Rust architecture, structured crate design, and explicit focus on security hardening. It features sandbox boundaries, permissions controls (including Agent Client Protocol / ACP support), and XDG directory compliance, ensuring deterministic and safe execution within local dev environments. VTCode is distributed as open-source software under standard open-source licensing and can be installed via Homebrew and package managers, requiring users to bring their own API keys or supported model providers.
Rust-powered architecture — Built with modular Rust crates to deliver low latency, fast startup times, and minimal memory overhead. - Bounded code search — Uses optimized search contracts and caching routines to locate symbols and code definitions across large repositories. - Security & sandbox boundaries — Enforces sandbox constraints and structured provider interfaces to prevent unsafe execution during agent loops. - Agent Client Protocol (ACP) permissions — Implements permission models and permission coverage for agent tool execution. - XDG user directory compliance — Follows standard XDG base directory specifications for configuration, state, and user data management. - Automated search cache invalidation — Automatically invalidates and refreshes search indexes and replay buffers when patches or edits are applied.
Use cases
Use Case: Terminal-Based Codebase Refactoring Developers can invoke VTCode directly in their terminal to perform multi-file refactoring, variable renames, or architectural migrations. The agent inspects file outlines, generates patches, and updates source code while enforcing workspace lint rules.
Use Case: Bounded Code Exploration and Search Engineers exploring unfamiliar or large codebases can query VTCode to map function calls, dependencies, and type contracts. VTCode leverages bounded code search routines to return targeted outline batches without blowing context limits.
Use Case: Automated Security and Lint Patching Developers can run VTCode to parse security audit findings, address compiler warnings, and fix code lint failures. The agent executes within designated sandbox boundaries to iteratively apply and verify code fixes.
Who it is for
VTCode is designed for software engineers, systems programmers, and terminal-first developers who prefer lightweight, Rust-native CLI tools over heavyweight IDE plugins. It is particularly suited for teams requiring strict local sandboxing and explicit tool permission controls. It may not be ideal for developers seeking GUI-driven diff viewers or non-technical end-users.
Install guide
Installation Install VTCode via Homebrew: bash brew tap vinhnx/vtcode brew install vtcode Alternatively, install from source using Cargo: bash cargo install --git https://github.com/vinhnx/vtcode
First Run Configure your provider API key as an environment variable or run the initialization routine: bash export OPENAI_API_KEY="your-api-key-here" # or set up your chosen provider credentials vtcode --help
Example Session Start an interactive coding session in your repository: bash vtcode "Refactor the search cache to invalidate results after workspace edits and verify lint passes"
Qwen Code — Qwen Code is an open-source terminal-based AI coding assistant maintained by the Qwen team (Alibaba Cloud / QwenLM). Built on…
ob-1 — ob-1 is an open-source terminal-based AI coding agent created by Overbrilliant. Designed for developer workflows in the shell, it orchestrates…
coro-code — coro-code is an open-source, terminal-based AI coding assistant developed in Rust by Blushyes. Built around a compiled native architecture, it…
Groq Code CLI — Groq Code CLI is an open-source command-line coding assistant developed by the build-with-groq team. It integrates directly with Groq's high-speed…
Nanocoder — Nanocoder is an open-source terminal-based AI coding assistant developed by the Nano-Collective community. Designed for software developers who prefer working…
CodeWhale — CodeWhale is an open-source terminal-based AI coding agent developed in Rust by Hunter Bown. It provides an autonomous and semi-autonomous…