VT Code

An open-source coding agent for your terminal.

Plan, build, and review with hosted or local models, sandboxed tools, and resumable sessions.

Contents

• VT Code
  • Overview
  • Quick start
    • 1. Install
    • 2. Configure your project
    • 3. Run your first task
  • Usage
    • Interactive
    • Headless
    • Scheduled tasks
    • Sessions
  • Integrations
  • Documentation
  • Development
  • Contributing
  • Security
  • Community
    • Security Advisors
    • Main Contributor
    • Core Contributors
    • Contributors
  • Support the project
    • Resources
    • Share VT Code
    • Sponsorship
  • License

Overview

Explore a codebase, plan changes, run tools, and review edits, in the interactive TUI or headless with vtcode exec. You pick the model and the permissions; the runtime handles context management, tool calls, and execution policy.

At a glance	What you get
Planning	Plan read-only, then review turn diffs.
Safety	Auditable command policy and sandboxing.
Self-correct	HOVER loop: Hypothesize, Observe,
	Verify, Evaluate, Revise, Repeat on tool mismatch.
Long runs	Headless exec with compaction, resumption, and logs.
Integrations	MCP, Skills, plugins, and editor bridges.
Models	Hosted or local providers, chosen per task.

flowchart LR
    H[Hypothesize] --> O[Observe tool evidence]
    O --> V[Verify outcome]
    V --> E[Evaluate vs hypothesis]
    E -->|mismatch| R[Revise and retry corrected]
    R --> H
    E -->|match| D[Done]

Legend: H states the expected outcome; O collects bounded tool evidence; V checks exit status and verifier result; E compares expectation against evidence; R applies an evidence-supported correction. mismatch (non-zero exit, empty search, stale patch, failed verifier, repeated evidence) loops back with corrected arguments; match exits to Done. Rereads alone are not revision. Full acceptance table: HOVER validation.

The rest of this page covers installation, configuration, a first task, and the deeper topics.

Quick start

Requirements: macOS, Linux, or Windows/WSL. Installing with Cargo also requires Rust 1.98.1+ (edition 2024).

1. Install