vtcode-core

Core library for VT Code — a Rust-based terminal coding agent.

vtcode-core powers the VT Code agent runtime. It provides the reusable building blocks for multi-provider LLM orchestration, tool execution, semantic code analysis, and configurable safety policies.

Highlights

• Provider Abstraction — unified LLM interface with adapters for OpenAI, Anthropic, xAI, DeepSeek, Gemini, OpenRouter, and Ollama, including automatic failover and spend controls.
• Prompt Caching — cross-provider caching system that leverages provider-specific mechanisms (OpenAI automatic, Anthropic cache_control, Gemini implicit/explicit) to reduce cost and latency.
• Semantic Workspace Model — LLM-native code analysis and navigation across modern programming languages.
• Bash Shell Safety — tree-sitter-bash integration for critical command validation and security enforcement.
• Tool System — trait-driven registry for shell execution, file IO, search, and custom commands, with Tokio-powered concurrency and PTY streaming.
• Ownership-First Tool Bridging — prefer native CGP wrappers and borrowed tool references; use Arc<dyn Tool> bridges only when tools genuinely need shared ownership.
• Configuration-First — everything is driven by vtcode.toml, with model, safety, and automation constants centralized in config::constants.
• Safety & Observability — workspace boundary enforcement, command allow/deny lists, human-in-the-loop confirmation, and structured event logging.

Modules

Public entrypoints

• Agent / AgentRunner — main agent runtime
• VTCodeConfig — configuration loader (vtcode.toml + environment overrides)
• ToolRegistry / OptimizedToolRegistry — tool registration and execution
• AnyClient / make_client — provider-agnostic LLM client factory
• PromptCache / PromptOptimizer — prompt caching primitives
• ThreadManager — thread lifecycle and event recording

Usage

use vtcode_core::{Agent, VTCodeConfig};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let config = VTCodeConfig::load()?;
    let agent = Agent::new(config).await?;
    agent.run().await?;
    Ok(())
}

Feature flags

API reference

See docs.rs/vtcode-core.

Related docs

• Architecture overview