vtcode 0.116.4

Table of contents

• Table of contents
• What is VT Code?
• Core capabilities
• Install
  • macOS and Linux
  • Windows PowerShell
  • Package managers
• Quick start
• Configuration
  • Atlas Cloud
• Extension points
  • Skills
  • MCP
  • Agents and editors
• Safety model
• Protocols and exports
• Benchmarks
• Documentation
• Development
• Contributing
• Support
• Star History
• License

What is VT Code?

VT Code is an open-source coding agent for the terminal. It combines a model-driven reasoning loop with a local harness that can read files, search code, edit safely, run commands, preserve context, resume sessions, and connect to external tools.

The default workflow is intentionally simple: one reliable agent loop, explicit delegation for bounded side work, and a workspace-first security model.

Core capabilities

Install

macOS and Linux

curl -fsSL https://raw.githubusercontent.com/vinhnx/vtcode/main/scripts/install.sh | bash

Skip optional search tools:

curl -fsSL https://raw.githubusercontent.com/vinhnx/vtcode/main/scripts/install.sh | bash -s -- --without-search-tools

Windows PowerShell

irm https://raw.githubusercontent.com/vinhnx/vtcode/main/scripts/install.ps1 | iex

[!NOTE] Windows release artifacts are best-effort and may lag behind macOS/Linux builds.

Package managers

cargo install vtcode
brew install vtcode

# Development tap
brew tap vinhnx/tap
brew install vinhnx/tap/vtcode

[!TIP] Official macOS/Linux release archives include ghostty-vt/ runtime libraries for richer PTY snapshots. Custom installs continue to work with the built-in legacy_vt100 backend.

More details: Installation Guide, Native Installer Guide, Ghostty VT Packaging.

Quick start

Set a provider key and launch VT Code in a project:

export OPENAI_API_KEY="sk-..."
vtcode

Common commands:

vtcode ask "write a Rust factorial function" > factorial.rs
vtcode exec "summarize the current git diff"
vtcode --resume
vtcode --continue

VT Code keeps primary output on stdout and sends logs, metadata, reasoning traces, and prompts to stderr. This keeps ask and exec useful in shell pipelines.

Configuration

Most settings live in vtcode.toml. Runtime overrides use --config key=value.

[agent]
provider = "openai"
default_model = "gpt-5.4"

Atlas Cloud

Atlas Cloud is a new LLM provider in VT Code. It works through VT Code's [[custom_providers]] support, so you can point VT Code at https://api.atlascloud.ai/v1 without adding a dedicated runtime provider.

[agent]
provider = "atlascloud"
default_model = "deepseek-ai/deepseek-v4-flash"

[[custom_providers]]
name = "atlascloud"
display_name = "Atlas Cloud"
base_url = "https://api.atlascloud.ai/v1"
api_key_env = "ATLASCLOUD_API_KEY"
model = "deepseek-ai/deepseek-v4-flash"

Other custom OpenAI-compatible providers use the same [[custom_providers]] pattern.

Useful configuration docs:

• Provider Guides
• Configuration Precedence
• Config Field Reference
• Tool Configuration
• Lifecycle Hooks

Extension points

Skills

VT Code discovers repository, user, admin, and bundled system skills using the open Agent Skills SKILL.md format.

vtcode skills list
vtcode skills info my-skill
vtcode skills create my-skill
vtcode skills validate ./.agents/skills/my-skill

Read: Agent Skills Guide.

MCP

VT Code can connect to external MCP servers over stdio or HTTP transports. It can also expose curated tools through its embedded MCP server. The MCP config covers providers, concurrency, timeouts, allowlists, UI rendering, auth, rate limits, and validation.

Read: MCP Integration Guide.

Agents and editors

• Subagents
• Agent Client Protocol and Zed
• IDE Downloads
• IDE Troubleshooting

Safety model

VT Code uses layered controls for shell and filesystem access:

• Command allowlist
• Per-command argument validation
• Workspace path normalization and symlink checks
• Dangerous command blocking
• Optional sandbox integration
• Human approval gates
• Auditable execution logs

The model is designed to reduce prompt injection, argument injection, workspace escape, and privilege escalation risk while keeping developer workflows practical.

• Security Model
• Command Security Model
• Execution Policy
• Sandbox Deep Dive
• Tool Policies

Protocols and exports

Benchmarks

VT Code has a pending submission to vercel/next-evals-oss, the benchmark behind the Next.js AI Agent Evaluations leaderboard.

Read: benchmark notes, eval framework.

Documentation

Start here:

• Documentation Hub
• Documentation Map
• Getting Started
• Interactive Mode
• Commands
• Exec Mode
• Context Engineering
• Architecture
• Development
• FAQ

Ask docs assistants: Google Gemini CodeWiki or Devin DeepWiki.

Development

git clone https://github.com/vinhnx/vtcode.git
cd vtcode
./scripts/run-debug.sh

Useful checks:

./scripts/check-dev.sh
./scripts/check-dev.sh --test
./scripts/check-dev.sh --workspace

VT Code uses Rust stable, edition 2024, and MSRV 1.88.

Read: Development Setup, Testing, CI/CD.

Contributing

VT Code is an open-source project, and I would love for more people to help shape it. Whether you are fixing a typo, improving docs, reporting a bug, testing a model provider, sharing an idea, or sending code, your contribution is welcome.

If you are new here, start with open issues or good first issues. For larger changes, please read CONTRIBUTING.md and AGENTS.md first so we can keep the project easy to review and maintain together.

Support

VT Code is built in my spare time and shared freely with the community. If it helps you ship code, learn, experiment with agents, or save a few hours, a small donation helps me keep improving it.

You can support ongoing development at buymeacoffee.com/vinhnx. Stars, issues, feedback, and word of mouth also mean a lot.

Star History

If you find VT Code useful, please consider starring the repository. It helps more developers discover the project and gives the community a visible signal that the work is valuable.

License

This repository is licensed under the MIT License.